> ## Documentation Index
> Fetch the complete documentation index at: https://help.weavely.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Identity API

> Retrieve user profiles and team data using Weavely’s Identity API. Access identity details, list teams, and manage form access securely.

<span className="weavely-jsonld" hidden>
  {`{
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "WebPage",
        "@id": "https://help.weavely.ai/developers/identity",
        "url": "https://help.weavely.ai/developers/identity",
        "name": "Identity API",
        "description": "Endpoints for retrieving and managing the authenticated user's identity.",
        "inLanguage": "en",
        "isPartOf": {
          "@type": "WebSite",
          "@id": "https://help.weavely.ai/#website",
          "name": "Weavely Help Center"
        },
        "breadcrumb": {
          "@type": "BreadcrumbList",
          "itemListElement": [
            { "@type": "ListItem", "position": 1, "name": "Developers", "item": "https://help.weavely.ai/developers" },
            { "@type": "ListItem", "position": 2, "name": "Identity API", "item": "https://help.weavely.ai/developers/identity" }
          ]
        },
        "publisher": { "@id": "https://www.weavely.ai/#org" }
      },
      {
        "@type": "TechArticle",
        "headline": "Identity API",
        "description": "Learn how to retrieve user profiles, list teams, and manage form access with Weavely’s Identity API.",
        "inLanguage": "en",
        "mainEntityOfPage": { "@id": "https://help.weavely.ai/developers/identity" },
        "author": { "@id": "https://www.weavely.ai/#org" },
        "publisher": { "@id": "https://www.weavely.ai/#org" }
      },
      {
        "@type": "Organization",
        "@id": "https://www.weavely.ai/#org",
        "name": "WEAVE.LY BV",
        "url": "https://www.weavely.ai",
        "address": {
          "@type": "PostalAddress",
          "streetAddress": "Herbert Hooverlaan 141",
          "addressLocality": "Schaarbeek",
          "postalCode": "1030",
          "addressCountry": "BE"
        },
        "identifier": "BE0773.878.569",
        "sameAs": [
          "https://www.instagram.com/weavely.ai/",
          "https://www.linkedin.com/company/weave-ly/",
          "https://www.youtube.com/@weavely"
        ]
      }
    ]
    }`}
</span>

## Get profile

> GET api.weavely.ai/v1/profile

### Request

#### Headers

<ParamField header="Authorization" type="string" required>
  `Bearer <token>`\
  Your personal token.
</ParamField>

### Response

<ResponseField name="id" type="string">
  The user's unique identifier.
</ResponseField>

<ResponseField name="name" type="string">
  The user's full name.
</ResponseField>

<ResponseField name="email" type="string">
  The user's email address.
</ResponseField>

## List teams

> GET api.weavely.ai/v1/teams

### Request

#### Headers

<ParamField header="Authorization" type="string" required>
  `Bearer <token>`\
  Your personal token.
</ParamField>

### Response

<ResponseField name="totalItems" type="integer">
  The total number of teams available.
</ResponseField>

<ResponseField name="items" type="array">
  An array of team objects.
</ResponseField>

<ResponseField name="items[].id" type="string">
  The team's unique identifier.
</ResponseField>

<ResponseField name="items[].name" type="string">
  The team's name.
</ResponseField>

## List forms in a team

> GET api.weavely.ai/v1/teams/:teamId/forms

### Request

#### Headers

<ParamField header="Authorization" type="string" required>
  `Bearer <token>`\
  Your personal token.
</ParamField>

#### Path Parameters

<ParamField path="teamId" type="string" required>
  The unique identifier of the team.
</ParamField>

#### Query Parameters

<ParamField query="published" type="boolean">
  If `true`, only returns forms that have a published version.
</ParamField>

### Response

<ResponseField name="totalItems" type="integer">
  The total number of forms available.
</ResponseField>

<ResponseField name="items" type="array">
  An array of form objects.
</ResponseField>

<ResponseField name="items[].id" type="string">
  The form's unique identifier.
</ResponseField>

<ResponseField name="items[].name" type="string">
  The form's name.
</ResponseField>