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

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

# PersonFirmV2

An association between a person and a firm.

## 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:
    PersonFirmV2:
      title: PersonFirmV2
      description: An association between a person and a firm.
      type: object
      required:
        - personId
        - firmId
        - role
      properties:
        personId:
          type: string
          format: uuid
          description: The unique identifier of the associated person.
          readOnly: true
          example: 550e8400-e29b-41d4-a716-446655440000
        firmId:
          type: string
          format: uuid
          description: The unique identifier of the associated firm.
          readOnly: true
          example: 660e8400-e29b-41d4-a716-446655440111
        role:
          type: string
          enum:
            - PRINCIPAL
            - AGENT_FIRM_MANAGER
            - AGENT
          description: The person's role in the firm.
          example: PRINCIPAL
```