---
title: "AssociateFirmRequestV2"
url: "https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8/schemas/AssociateFirmRequestV2"
---

> Full API specification: https://developer-staging.agentsync.io/apis/identity/versions/1ed33a2c-924a-434c-9643-fbc531dea1b8.md

# AssociateFirmRequestV2

Identifies the existing firm to associate with the person, and optionally the person's role in it.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Identity API
  version: v1.275.8
servers:
  - url: https://api.sandbox.agentsync.io/id
    description: Sandbox server
  - url: https://api.agentsync.io/id
    description: Production server
components:
  schemas:
    AssociateFirmRequestV2:
      title: AssociateFirmRequestV2
      description: Identifies the existing firm to associate with the person, and
        optionally the person's role in it.
      type: object
      required:
        - firmId
      properties:
        firmId:
          type: string
          format: uuid
          description: The unique identifier of the firm to associate.
          example: 550e8400-e29b-41d4-a716-446655440000
        role:
          type: string
          enum:
            - PRINCIPAL
            - AGENT_FIRM_MANAGER
            - AGENT
          default: PRINCIPAL
          description: The person's role in the firm. Defaults to PRINCIPAL when omitted.
          example: PRINCIPAL
```