> For the complete documentation index, see [llms.txt](https://knowledgebase.fabricdata.com/studio/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.fabricdata.com/studio/integrations-and-apis/origin-studio-production-api/contributors.md).

# Contributors

Manage contributors in the context of a tenant. Create and manage contributor records (people and organizations) for use in credits and metadata.

## Create a single contributor

> Create a single contributor. Tenants can create their own contributors.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2264"},"tags":[{"name":"Contributors","description":"Manage contributors in the context of a tenant. Create and manage contributor records (people and organizations) for use in credits and metadata."}],"servers":[{"url":"{protocol}://{domain}/{basePath}","variables":{"protocol":{"enum":["http","https"],"default":"https"},"domain":{"default":"api.studio.fabricdata.com"},"basePath":{"default":"v1"}}}],"security":[{"jwt-apikey-authorizer":[]}],"components":{"securitySchemes":{"jwt-apikey-authorizer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"ContributorCreateOneRequest":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorCreateOneRequest","description":"Request body for creating a new contributor. Follows the JSON:API resource creation format with `type: 'contributors'` and an `attributes` object. The `name` field is required; all other attributes are optional. Set `dataSource` to `'custom'` for manually created contributors.","type":"object","properties":{"meta":{"$ref":"#/components/schemas/WriteRequestMeta"},"data":{"allOf":[{"$ref":"#/components/schemas/ContributorResourceType"},{"type":"object","required":["attributes"],"additionalProperties":false,"properties":{"attributes":{"allOf":[{"$ref":"#/components/schemas/ContributorAttributesInput"},{"type":"object","required":["name"],"additionalProperties":false,"properties":{"name":{"$ref":"#/components/schemas/ContributorAttributeName"},"dataSource":{"$ref":"#/components/schemas/ContributorAttributeDataSource"}}}]}}}]}},"required":["data"],"additionalProperties":false},"WriteRequestMeta":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IWriteRequestMeta","description":"Optional audit metadata for a write request. `audit.source` is the issuing surface/channel (e.g. studio-web, mcp, api, system); `audit.reason` is a free-text justification. Both are optional and length-capped.","type":"object","additionalProperties":false,"properties":{"audit":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string","maxLength":64},"reason":{"type":"string","maxLength":256}}}}},"ContributorResourceType":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorResourceType","description":"JSON:API type discriminator for contributor resources. The `type` field is always `\"contributors\"`. Used as a base for contributor request and response shapes to enforce correct JSON:API resource typing.","type":"object","required":["type"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["contributors"]}}},"ContributorAttributesInput":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributesInput","description":"Editable attributes for a contributor, used as the base for both create and update request bodies. All fields are optional to support partial updates. Includes personal metadata (name, gender, birth details), cross-platform identifiers (IMDb, TMDB, Origin, Wikidata, social handles), profile image, localized descriptions, and data source indicator.","type":"object","required":[],"additionalProperties":false,"properties":{"name":{"$ref":"#/components/schemas/ContributorAttributeName"},"gender":{"$ref":"#/components/schemas/ContributorAttributeGender"},"originRating":{"$ref":"#/components/schemas/ContributorAttributeOriginRating"},"birthDate":{"$ref":"#/components/schemas/ContributorAttributeBirthDate"},"deathDate":{"type":"string","description":"The contributor's date of death, if applicable. Stored as a string to accommodate partial dates (year-only or year-month) as well as full ISO 8601 dates."},"birthName":{"$ref":"#/components/schemas/ContributorAttributeBirthName"},"image":{"$ref":"#/components/schemas/ContributorAttributeImage"},"altNames":{"type":"array","description":"A list of alternative names or known aliases for the contributor (e.g., stage names, maiden names, transliterations). Each value must be unique within the array.","items":{"type":"string"},"uniqueItems":true},"originNexusId":{"$ref":"#/components/schemas/ContributorAttributeOriginNexusId"},"tmdbId":{"type":"string","description":"The contributor's ID in The Movie Database (TMDB). Used for cross-referencing with TMDB person records."},"imdbId":{"$ref":"#/components/schemas/ContributorAttributeImdbId"},"facebookId":{"type":"string","description":"The contributor's Facebook profile identifier or username."},"instagramId":{"type":"string","description":"The contributor's Instagram handle or profile identifier."},"twitterId":{"type":"string","description":"The contributor's Twitter/X handle or profile identifier."},"freebaseMidId":{"type":"string","description":"The contributor's Freebase machine ID (MID), a stable identifier from the Freebase knowledge graph."},"freebaseId":{"type":"string","description":"The contributor's Freebase topic ID, a human-readable identifier from the Freebase knowledge graph."},"tvRageId":{"type":"string","description":"The contributor's ID on the TVRage database."},"tvMediaId":{"type":"string","description":"The contributor's ID in the TV Media database."},"wikiDataId":{"type":"string","description":"The contributor's Wikidata entity ID (e.g., `Q12345`). Used for cross-referencing with the Wikidata knowledge base."},"wikiMediaId":{"type":"string","description":"The contributor's Wikimedia Commons identifier, typically used for linking to media files hosted on Wikimedia."},"handIdentityId":{"type":"string","description":"The contributor's identifier in the HAND (Hollywood Accounting Network Database) system."},"descriptions":{"type":"array","description":"A list of localized biographical descriptions for the contributor, sourced from external providers. Each entry is keyed by a unique identifier and scoped to a locale.","items":{"type":"object","required":["key","value","locale","attribution"],"additionalProperties":false,"properties":{"key":{"type":"string","description":"A unique key identifying this description entry, typically the locale code or a provider-specific identifier."},"value":{"type":"string","description":"The biographical text content for this description."},"locale":{"type":"string","description":"BCP 47 language tag for the description's language (e.g., `en`, `fr`, `es`)."},"attribution":{"type":"string","description":"The name or identifier of the source providing this description (e.g., a data provider name)."}}}},"dataSource":{"$ref":"#/components/schemas/ContributorAttributeDataSource"}}},"ContributorAttributeName":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeName","description":"The contributor's display name. For most contributors this is their full name (e.g., 'John Doe'). Required when creating a contributor.","type":"string"},"ContributorAttributeGender":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeGender","description":"The contributor's gender. Sourced from the external metadata provider when the contributor originates from Origin.","type":"string","enum":["male","female"]},"ContributorAttributeOriginRating":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeOriginRating","description":"A normalized popularity or relevance score for the contributor as provided by the Origin metadata provider. Higher values indicate greater prominence.","type":"number"},"ContributorAttributeBirthDate":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeBirthDate","description":"The contributor's date of birth. Stored as a string to accommodate partial dates (year-only or year-month) as well as full ISO 8601 dates.","type":"string"},"ContributorAttributeBirthName":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeBirthName","description":"The contributor's birth name or legal name, if different from their primary display name (e.g., a stage name or alias is used as the primary name).","type":"string"},"ContributorAttributeImage":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeImage","description":"A profile image for the contributor. Contains the image URL and its pixel dimensions.","type":"object","required":["url","width","height"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"The fully qualified URL of the profile image."},"width":{"type":"number","description":"The image width in pixels."},"height":{"type":"number","description":"The image height in pixels."}}},"ContributorAttributeOriginNexusId":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeOriginNexusId","description":"The contributor's unique identifier in Origin Nexus. Used to link Origin Studio contributors to their corresponding Origin Nexus records and to sync updates.","type":"string"},"ContributorAttributeImdbId":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeImdbId","description":"The contributor's IMDb person ID (e.g., 'nm0000093'). Used for cross-referencing with the Internet Movie Database.","type":"string"},"ContributorAttributeDataSource":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeDataSource","description":"Indicates the origin of the contributor's data. `originNexus` means the record was ingested from Origin Nexus and may be updated by automated sync jobs. `custom` means the record was created manually by the tenant and is not subject to automated overwrites.","type":"string","enum":["originNexus","custom"]},"ContributorCreateOneResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorCreateOneResponse","description":"Response returned after successfully creating a contributor. Contains the new contributor's ID, type, full attribute set, and relationship links to the owning tenant.","type":"object","additionalProperties":false,"required":["data"],"properties":{"data":{"allOf":[{"$ref":"#/components/schemas/ContributorResourceType"},{"type":"object","required":["id","type","attributes","relationships"],"additionalProperties":false,"properties":{"id":{"type":"string"},"attributes":{"$ref":"#/components/schemas/ContributorAttributes"},"relationships":{"$ref":"#/components/schemas/ContributorRelationships"},"links":{"$ref":"#/components/schemas/LinksSelf"}}}]}}},"ContributorAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributes","description":"Full set of attributes for a stored contributor, combining all editable input fields with system-managed fields (status, dataSource) and base resource timestamps. Returned in contributor read and write responses.","allOf":[{"$ref":"#/components/schemas/ContributorAttributesInput"},{"$ref":"#/components/schemas/BaseResourceAttributes"},{"type":"object","required":["status"],"additionalProperties":false,"properties":{"status":{"$ref":"#/components/schemas/ContributorAttributeStatus"},"dataSource":{"$ref":"#/components/schemas/ContributorAttributeDataSource"}}}]},"BaseResourceAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBaseResourceAttributes","description":"Common timestamps present on all resource attribute objects. `created` is the ISO 8601 date-time when the resource was first created; `updated` is the date-time of the most recent modification.","type":"object","additionalProperties":false,"required":["created","updated"],"properties":{"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"}}},"ContributorAttributeStatus":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeStatus","description":"Lifecycle status of the contributor. `active` means the contributor is available for use. `pendingDeletion` means a delete job has been initiated and the contributor will be removed once all associated credits are cleaned up.","type":"string","enum":["active","pendingDeletion"]},"ContributorRelationships":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorRelationships","description":"JSON:API relationship links for a contributor resource. Currently contains the owning tenant relationship.","type":"object","properties":{"tenant":{"$ref":"#/components/schemas/TenantRelationship"}},"required":["tenant"],"additionalProperties":false},"TenantRelationship":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ITenantRelationship","description":"A relationship to a tenant","type":"object","properties":{"data":{"additionalProperties":false,"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"required":["id","type"]},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"LinksRelated":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ILinks","description":"A JSON:API links object with an absolute or relative 'related' link","type":"object","required":["related"],"properties":{"related":{"type":"string"}},"additionalProperties":false},"LinksSelf":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ILinksSelf","description":"A JSON:API links object with an absolute or relative 'self' link","type":"object","required":["self"],"properties":{"self":{"type":"string"}},"additionalProperties":false}}},"paths":{"/contributors":{"post":{"summary":"Create a single contributor","operationId":"contributorCreateOne","description":"Create a single contributor. Tenants can create their own contributors.","tags":["Contributors"],"parameters":[{"name":"tenantId","description":"The ID of the tenant to create the contributor for.","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContributorCreateOneRequest"}}}},"responses":{"201":{"description":"Created OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContributorCreateOneResponse"}}}}}}}}}
```

## Get a single contributor

> Get a single contributor by ID. For the moment only system-owned contributors can be retrieved.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2264"},"tags":[{"name":"Contributors","description":"Manage contributors in the context of a tenant. Create and manage contributor records (people and organizations) for use in credits and metadata."}],"servers":[{"url":"{protocol}://{domain}/{basePath}","variables":{"protocol":{"enum":["http","https"],"default":"https"},"domain":{"default":"api.studio.fabricdata.com"},"basePath":{"default":"v1"}}}],"security":[{"jwt-apikey-authorizer":[]}],"components":{"securitySchemes":{"jwt-apikey-authorizer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"ContributorFindOneResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorFindOneResponse","description":"Response returned when retrieving a single contributor by ID. Contains the full contributor resource including all attributes (name, identifiers, biography descriptions, image) and relationship links to the owning tenant.","type":"object","additionalProperties":false,"required":["data","links"],"properties":{"data":{"type":"object","required":["id","type","attributes","relationships"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"$ref":"#/components/schemas/ContributorResourceType"},"attributes":{"$ref":"#/components/schemas/ContributorAttributes"},"relationships":{"$ref":"#/components/schemas/ContributorRelationships"}}},"links":{"$ref":"#/components/schemas/LinksSelf"}}},"ContributorResourceType":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorResourceType","description":"JSON:API type discriminator for contributor resources. The `type` field is always `\"contributors\"`. Used as a base for contributor request and response shapes to enforce correct JSON:API resource typing.","type":"object","required":["type"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["contributors"]}}},"ContributorAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributes","description":"Full set of attributes for a stored contributor, combining all editable input fields with system-managed fields (status, dataSource) and base resource timestamps. Returned in contributor read and write responses.","allOf":[{"$ref":"#/components/schemas/ContributorAttributesInput"},{"$ref":"#/components/schemas/BaseResourceAttributes"},{"type":"object","required":["status"],"additionalProperties":false,"properties":{"status":{"$ref":"#/components/schemas/ContributorAttributeStatus"},"dataSource":{"$ref":"#/components/schemas/ContributorAttributeDataSource"}}}]},"ContributorAttributesInput":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributesInput","description":"Editable attributes for a contributor, used as the base for both create and update request bodies. All fields are optional to support partial updates. Includes personal metadata (name, gender, birth details), cross-platform identifiers (IMDb, TMDB, Origin, Wikidata, social handles), profile image, localized descriptions, and data source indicator.","type":"object","required":[],"additionalProperties":false,"properties":{"name":{"$ref":"#/components/schemas/ContributorAttributeName"},"gender":{"$ref":"#/components/schemas/ContributorAttributeGender"},"originRating":{"$ref":"#/components/schemas/ContributorAttributeOriginRating"},"birthDate":{"$ref":"#/components/schemas/ContributorAttributeBirthDate"},"deathDate":{"type":"string","description":"The contributor's date of death, if applicable. Stored as a string to accommodate partial dates (year-only or year-month) as well as full ISO 8601 dates."},"birthName":{"$ref":"#/components/schemas/ContributorAttributeBirthName"},"image":{"$ref":"#/components/schemas/ContributorAttributeImage"},"altNames":{"type":"array","description":"A list of alternative names or known aliases for the contributor (e.g., stage names, maiden names, transliterations). Each value must be unique within the array.","items":{"type":"string"},"uniqueItems":true},"originNexusId":{"$ref":"#/components/schemas/ContributorAttributeOriginNexusId"},"tmdbId":{"type":"string","description":"The contributor's ID in The Movie Database (TMDB). Used for cross-referencing with TMDB person records."},"imdbId":{"$ref":"#/components/schemas/ContributorAttributeImdbId"},"facebookId":{"type":"string","description":"The contributor's Facebook profile identifier or username."},"instagramId":{"type":"string","description":"The contributor's Instagram handle or profile identifier."},"twitterId":{"type":"string","description":"The contributor's Twitter/X handle or profile identifier."},"freebaseMidId":{"type":"string","description":"The contributor's Freebase machine ID (MID), a stable identifier from the Freebase knowledge graph."},"freebaseId":{"type":"string","description":"The contributor's Freebase topic ID, a human-readable identifier from the Freebase knowledge graph."},"tvRageId":{"type":"string","description":"The contributor's ID on the TVRage database."},"tvMediaId":{"type":"string","description":"The contributor's ID in the TV Media database."},"wikiDataId":{"type":"string","description":"The contributor's Wikidata entity ID (e.g., `Q12345`). Used for cross-referencing with the Wikidata knowledge base."},"wikiMediaId":{"type":"string","description":"The contributor's Wikimedia Commons identifier, typically used for linking to media files hosted on Wikimedia."},"handIdentityId":{"type":"string","description":"The contributor's identifier in the HAND (Hollywood Accounting Network Database) system."},"descriptions":{"type":"array","description":"A list of localized biographical descriptions for the contributor, sourced from external providers. Each entry is keyed by a unique identifier and scoped to a locale.","items":{"type":"object","required":["key","value","locale","attribution"],"additionalProperties":false,"properties":{"key":{"type":"string","description":"A unique key identifying this description entry, typically the locale code or a provider-specific identifier."},"value":{"type":"string","description":"The biographical text content for this description."},"locale":{"type":"string","description":"BCP 47 language tag for the description's language (e.g., `en`, `fr`, `es`)."},"attribution":{"type":"string","description":"The name or identifier of the source providing this description (e.g., a data provider name)."}}}},"dataSource":{"$ref":"#/components/schemas/ContributorAttributeDataSource"}}},"ContributorAttributeName":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeName","description":"The contributor's display name. For most contributors this is their full name (e.g., 'John Doe'). Required when creating a contributor.","type":"string"},"ContributorAttributeGender":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeGender","description":"The contributor's gender. Sourced from the external metadata provider when the contributor originates from Origin.","type":"string","enum":["male","female"]},"ContributorAttributeOriginRating":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeOriginRating","description":"A normalized popularity or relevance score for the contributor as provided by the Origin metadata provider. Higher values indicate greater prominence.","type":"number"},"ContributorAttributeBirthDate":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeBirthDate","description":"The contributor's date of birth. Stored as a string to accommodate partial dates (year-only or year-month) as well as full ISO 8601 dates.","type":"string"},"ContributorAttributeBirthName":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeBirthName","description":"The contributor's birth name or legal name, if different from their primary display name (e.g., a stage name or alias is used as the primary name).","type":"string"},"ContributorAttributeImage":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeImage","description":"A profile image for the contributor. Contains the image URL and its pixel dimensions.","type":"object","required":["url","width","height"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"The fully qualified URL of the profile image."},"width":{"type":"number","description":"The image width in pixels."},"height":{"type":"number","description":"The image height in pixels."}}},"ContributorAttributeOriginNexusId":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeOriginNexusId","description":"The contributor's unique identifier in Origin Nexus. Used to link Origin Studio contributors to their corresponding Origin Nexus records and to sync updates.","type":"string"},"ContributorAttributeImdbId":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeImdbId","description":"The contributor's IMDb person ID (e.g., 'nm0000093'). Used for cross-referencing with the Internet Movie Database.","type":"string"},"ContributorAttributeDataSource":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeDataSource","description":"Indicates the origin of the contributor's data. `originNexus` means the record was ingested from Origin Nexus and may be updated by automated sync jobs. `custom` means the record was created manually by the tenant and is not subject to automated overwrites.","type":"string","enum":["originNexus","custom"]},"BaseResourceAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBaseResourceAttributes","description":"Common timestamps present on all resource attribute objects. `created` is the ISO 8601 date-time when the resource was first created; `updated` is the date-time of the most recent modification.","type":"object","additionalProperties":false,"required":["created","updated"],"properties":{"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"}}},"ContributorAttributeStatus":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeStatus","description":"Lifecycle status of the contributor. `active` means the contributor is available for use. `pendingDeletion` means a delete job has been initiated and the contributor will be removed once all associated credits are cleaned up.","type":"string","enum":["active","pendingDeletion"]},"ContributorRelationships":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorRelationships","description":"JSON:API relationship links for a contributor resource. Currently contains the owning tenant relationship.","type":"object","properties":{"tenant":{"$ref":"#/components/schemas/TenantRelationship"}},"required":["tenant"],"additionalProperties":false},"TenantRelationship":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ITenantRelationship","description":"A relationship to a tenant","type":"object","properties":{"data":{"additionalProperties":false,"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"required":["id","type"]},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"LinksRelated":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ILinks","description":"A JSON:API links object with an absolute or relative 'related' link","type":"object","required":["related"],"properties":{"related":{"type":"string"}},"additionalProperties":false},"LinksSelf":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ILinksSelf","description":"A JSON:API links object with an absolute or relative 'self' link","type":"object","required":["self"],"properties":{"self":{"type":"string"}},"additionalProperties":false}}},"paths":{"/contributors/{contributorId}":{"get":{"summary":"Get a single contributor","operationId":"contributorFindOne","description":"Get a single contributor by ID. For the moment only system-owned contributors can be retrieved.","tags":["Contributors"],"parameters":[{"name":"contributorId","description":"The ID of the contributor to retrieve","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContributorFindOneResponse"}}}}}}}}}
```

## Update a single contributor

> Update a single contributor by ID. For the moment Tenants cannot update their own contributors.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2264"},"tags":[{"name":"Contributors","description":"Manage contributors in the context of a tenant. Create and manage contributor records (people and organizations) for use in credits and metadata."}],"servers":[{"url":"{protocol}://{domain}/{basePath}","variables":{"protocol":{"enum":["http","https"],"default":"https"},"domain":{"default":"api.studio.fabricdata.com"},"basePath":{"default":"v1"}}}],"security":[{"jwt-apikey-authorizer":[]}],"components":{"securitySchemes":{"jwt-apikey-authorizer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"ContributorUpdateOneRequest":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorUpdateOneRequest","description":"Request body for partially updating an existing contributor. All attribute fields are optional; only the fields present in the request body are modified. Follows the JSON:API PATCH format with `type: 'contributors'`.","type":"object","properties":{"meta":{"$ref":"#/components/schemas/WriteRequestMeta"},"data":{"allOf":[{"$ref":"#/components/schemas/ContributorResourceType"},{"type":"object","required":["attributes"],"additionalProperties":false,"properties":{"attributes":{"$ref":"#/components/schemas/ContributorAttributesInput"}}}]}},"required":["data"],"additionalProperties":false},"WriteRequestMeta":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IWriteRequestMeta","description":"Optional audit metadata for a write request. `audit.source` is the issuing surface/channel (e.g. studio-web, mcp, api, system); `audit.reason` is a free-text justification. Both are optional and length-capped.","type":"object","additionalProperties":false,"properties":{"audit":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string","maxLength":64},"reason":{"type":"string","maxLength":256}}}}},"ContributorResourceType":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorResourceType","description":"JSON:API type discriminator for contributor resources. The `type` field is always `\"contributors\"`. Used as a base for contributor request and response shapes to enforce correct JSON:API resource typing.","type":"object","required":["type"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["contributors"]}}},"ContributorAttributesInput":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributesInput","description":"Editable attributes for a contributor, used as the base for both create and update request bodies. All fields are optional to support partial updates. Includes personal metadata (name, gender, birth details), cross-platform identifiers (IMDb, TMDB, Origin, Wikidata, social handles), profile image, localized descriptions, and data source indicator.","type":"object","required":[],"additionalProperties":false,"properties":{"name":{"$ref":"#/components/schemas/ContributorAttributeName"},"gender":{"$ref":"#/components/schemas/ContributorAttributeGender"},"originRating":{"$ref":"#/components/schemas/ContributorAttributeOriginRating"},"birthDate":{"$ref":"#/components/schemas/ContributorAttributeBirthDate"},"deathDate":{"type":"string","description":"The contributor's date of death, if applicable. Stored as a string to accommodate partial dates (year-only or year-month) as well as full ISO 8601 dates."},"birthName":{"$ref":"#/components/schemas/ContributorAttributeBirthName"},"image":{"$ref":"#/components/schemas/ContributorAttributeImage"},"altNames":{"type":"array","description":"A list of alternative names or known aliases for the contributor (e.g., stage names, maiden names, transliterations). Each value must be unique within the array.","items":{"type":"string"},"uniqueItems":true},"originNexusId":{"$ref":"#/components/schemas/ContributorAttributeOriginNexusId"},"tmdbId":{"type":"string","description":"The contributor's ID in The Movie Database (TMDB). Used for cross-referencing with TMDB person records."},"imdbId":{"$ref":"#/components/schemas/ContributorAttributeImdbId"},"facebookId":{"type":"string","description":"The contributor's Facebook profile identifier or username."},"instagramId":{"type":"string","description":"The contributor's Instagram handle or profile identifier."},"twitterId":{"type":"string","description":"The contributor's Twitter/X handle or profile identifier."},"freebaseMidId":{"type":"string","description":"The contributor's Freebase machine ID (MID), a stable identifier from the Freebase knowledge graph."},"freebaseId":{"type":"string","description":"The contributor's Freebase topic ID, a human-readable identifier from the Freebase knowledge graph."},"tvRageId":{"type":"string","description":"The contributor's ID on the TVRage database."},"tvMediaId":{"type":"string","description":"The contributor's ID in the TV Media database."},"wikiDataId":{"type":"string","description":"The contributor's Wikidata entity ID (e.g., `Q12345`). Used for cross-referencing with the Wikidata knowledge base."},"wikiMediaId":{"type":"string","description":"The contributor's Wikimedia Commons identifier, typically used for linking to media files hosted on Wikimedia."},"handIdentityId":{"type":"string","description":"The contributor's identifier in the HAND (Hollywood Accounting Network Database) system."},"descriptions":{"type":"array","description":"A list of localized biographical descriptions for the contributor, sourced from external providers. Each entry is keyed by a unique identifier and scoped to a locale.","items":{"type":"object","required":["key","value","locale","attribution"],"additionalProperties":false,"properties":{"key":{"type":"string","description":"A unique key identifying this description entry, typically the locale code or a provider-specific identifier."},"value":{"type":"string","description":"The biographical text content for this description."},"locale":{"type":"string","description":"BCP 47 language tag for the description's language (e.g., `en`, `fr`, `es`)."},"attribution":{"type":"string","description":"The name or identifier of the source providing this description (e.g., a data provider name)."}}}},"dataSource":{"$ref":"#/components/schemas/ContributorAttributeDataSource"}}},"ContributorAttributeName":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeName","description":"The contributor's display name. For most contributors this is their full name (e.g., 'John Doe'). Required when creating a contributor.","type":"string"},"ContributorAttributeGender":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeGender","description":"The contributor's gender. Sourced from the external metadata provider when the contributor originates from Origin.","type":"string","enum":["male","female"]},"ContributorAttributeOriginRating":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeOriginRating","description":"A normalized popularity or relevance score for the contributor as provided by the Origin metadata provider. Higher values indicate greater prominence.","type":"number"},"ContributorAttributeBirthDate":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeBirthDate","description":"The contributor's date of birth. Stored as a string to accommodate partial dates (year-only or year-month) as well as full ISO 8601 dates.","type":"string"},"ContributorAttributeBirthName":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeBirthName","description":"The contributor's birth name or legal name, if different from their primary display name (e.g., a stage name or alias is used as the primary name).","type":"string"},"ContributorAttributeImage":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeImage","description":"A profile image for the contributor. Contains the image URL and its pixel dimensions.","type":"object","required":["url","width","height"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"The fully qualified URL of the profile image."},"width":{"type":"number","description":"The image width in pixels."},"height":{"type":"number","description":"The image height in pixels."}}},"ContributorAttributeOriginNexusId":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeOriginNexusId","description":"The contributor's unique identifier in Origin Nexus. Used to link Origin Studio contributors to their corresponding Origin Nexus records and to sync updates.","type":"string"},"ContributorAttributeImdbId":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeImdbId","description":"The contributor's IMDb person ID (e.g., 'nm0000093'). Used for cross-referencing with the Internet Movie Database.","type":"string"},"ContributorAttributeDataSource":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeDataSource","description":"Indicates the origin of the contributor's data. `originNexus` means the record was ingested from Origin Nexus and may be updated by automated sync jobs. `custom` means the record was created manually by the tenant and is not subject to automated overwrites.","type":"string","enum":["originNexus","custom"]}}},"paths":{"/contributors/{contributorId}":{"patch":{"summary":"Update a single contributor","operationId":"contributorUpdateOne","description":"Update a single contributor by ID. For the moment Tenants cannot update their own contributors.","tags":["Contributors"],"parameters":[{"name":"contributorId","description":"The ID of the contributor to update","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContributorUpdateOneRequest"}}}},"responses":{"204":{"description":"No Content","content":{"application/json":{}}}}}}}}
```

## Get a single system-owned contributor

> Get a single system-owned contributor by ID.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2264"},"tags":[{"name":"Contributors","description":"Manage contributors in the context of a tenant. Create and manage contributor records (people and organizations) for use in credits and metadata."}],"servers":[{"url":"{protocol}://{domain}/{basePath}","variables":{"protocol":{"enum":["http","https"],"default":"https"},"domain":{"default":"api.studio.fabricdata.com"},"basePath":{"default":"v1"}}}],"security":[{"jwt-apikey-authorizer":[]}],"components":{"securitySchemes":{"jwt-apikey-authorizer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"ContributorFindOneResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorFindOneResponse","description":"Response returned when retrieving a single contributor by ID. Contains the full contributor resource including all attributes (name, identifiers, biography descriptions, image) and relationship links to the owning tenant.","type":"object","additionalProperties":false,"required":["data","links"],"properties":{"data":{"type":"object","required":["id","type","attributes","relationships"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"$ref":"#/components/schemas/ContributorResourceType"},"attributes":{"$ref":"#/components/schemas/ContributorAttributes"},"relationships":{"$ref":"#/components/schemas/ContributorRelationships"}}},"links":{"$ref":"#/components/schemas/LinksSelf"}}},"ContributorResourceType":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorResourceType","description":"JSON:API type discriminator for contributor resources. The `type` field is always `\"contributors\"`. Used as a base for contributor request and response shapes to enforce correct JSON:API resource typing.","type":"object","required":["type"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["contributors"]}}},"ContributorAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributes","description":"Full set of attributes for a stored contributor, combining all editable input fields with system-managed fields (status, dataSource) and base resource timestamps. Returned in contributor read and write responses.","allOf":[{"$ref":"#/components/schemas/ContributorAttributesInput"},{"$ref":"#/components/schemas/BaseResourceAttributes"},{"type":"object","required":["status"],"additionalProperties":false,"properties":{"status":{"$ref":"#/components/schemas/ContributorAttributeStatus"},"dataSource":{"$ref":"#/components/schemas/ContributorAttributeDataSource"}}}]},"ContributorAttributesInput":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributesInput","description":"Editable attributes for a contributor, used as the base for both create and update request bodies. All fields are optional to support partial updates. Includes personal metadata (name, gender, birth details), cross-platform identifiers (IMDb, TMDB, Origin, Wikidata, social handles), profile image, localized descriptions, and data source indicator.","type":"object","required":[],"additionalProperties":false,"properties":{"name":{"$ref":"#/components/schemas/ContributorAttributeName"},"gender":{"$ref":"#/components/schemas/ContributorAttributeGender"},"originRating":{"$ref":"#/components/schemas/ContributorAttributeOriginRating"},"birthDate":{"$ref":"#/components/schemas/ContributorAttributeBirthDate"},"deathDate":{"type":"string","description":"The contributor's date of death, if applicable. Stored as a string to accommodate partial dates (year-only or year-month) as well as full ISO 8601 dates."},"birthName":{"$ref":"#/components/schemas/ContributorAttributeBirthName"},"image":{"$ref":"#/components/schemas/ContributorAttributeImage"},"altNames":{"type":"array","description":"A list of alternative names or known aliases for the contributor (e.g., stage names, maiden names, transliterations). Each value must be unique within the array.","items":{"type":"string"},"uniqueItems":true},"originNexusId":{"$ref":"#/components/schemas/ContributorAttributeOriginNexusId"},"tmdbId":{"type":"string","description":"The contributor's ID in The Movie Database (TMDB). Used for cross-referencing with TMDB person records."},"imdbId":{"$ref":"#/components/schemas/ContributorAttributeImdbId"},"facebookId":{"type":"string","description":"The contributor's Facebook profile identifier or username."},"instagramId":{"type":"string","description":"The contributor's Instagram handle or profile identifier."},"twitterId":{"type":"string","description":"The contributor's Twitter/X handle or profile identifier."},"freebaseMidId":{"type":"string","description":"The contributor's Freebase machine ID (MID), a stable identifier from the Freebase knowledge graph."},"freebaseId":{"type":"string","description":"The contributor's Freebase topic ID, a human-readable identifier from the Freebase knowledge graph."},"tvRageId":{"type":"string","description":"The contributor's ID on the TVRage database."},"tvMediaId":{"type":"string","description":"The contributor's ID in the TV Media database."},"wikiDataId":{"type":"string","description":"The contributor's Wikidata entity ID (e.g., `Q12345`). Used for cross-referencing with the Wikidata knowledge base."},"wikiMediaId":{"type":"string","description":"The contributor's Wikimedia Commons identifier, typically used for linking to media files hosted on Wikimedia."},"handIdentityId":{"type":"string","description":"The contributor's identifier in the HAND (Hollywood Accounting Network Database) system."},"descriptions":{"type":"array","description":"A list of localized biographical descriptions for the contributor, sourced from external providers. Each entry is keyed by a unique identifier and scoped to a locale.","items":{"type":"object","required":["key","value","locale","attribution"],"additionalProperties":false,"properties":{"key":{"type":"string","description":"A unique key identifying this description entry, typically the locale code or a provider-specific identifier."},"value":{"type":"string","description":"The biographical text content for this description."},"locale":{"type":"string","description":"BCP 47 language tag for the description's language (e.g., `en`, `fr`, `es`)."},"attribution":{"type":"string","description":"The name or identifier of the source providing this description (e.g., a data provider name)."}}}},"dataSource":{"$ref":"#/components/schemas/ContributorAttributeDataSource"}}},"ContributorAttributeName":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeName","description":"The contributor's display name. For most contributors this is their full name (e.g., 'John Doe'). Required when creating a contributor.","type":"string"},"ContributorAttributeGender":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeGender","description":"The contributor's gender. Sourced from the external metadata provider when the contributor originates from Origin.","type":"string","enum":["male","female"]},"ContributorAttributeOriginRating":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeOriginRating","description":"A normalized popularity or relevance score for the contributor as provided by the Origin metadata provider. Higher values indicate greater prominence.","type":"number"},"ContributorAttributeBirthDate":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeBirthDate","description":"The contributor's date of birth. Stored as a string to accommodate partial dates (year-only or year-month) as well as full ISO 8601 dates.","type":"string"},"ContributorAttributeBirthName":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeBirthName","description":"The contributor's birth name or legal name, if different from their primary display name (e.g., a stage name or alias is used as the primary name).","type":"string"},"ContributorAttributeImage":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeImage","description":"A profile image for the contributor. Contains the image URL and its pixel dimensions.","type":"object","required":["url","width","height"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"The fully qualified URL of the profile image."},"width":{"type":"number","description":"The image width in pixels."},"height":{"type":"number","description":"The image height in pixels."}}},"ContributorAttributeOriginNexusId":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeOriginNexusId","description":"The contributor's unique identifier in Origin Nexus. Used to link Origin Studio contributors to their corresponding Origin Nexus records and to sync updates.","type":"string"},"ContributorAttributeImdbId":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeImdbId","description":"The contributor's IMDb person ID (e.g., 'nm0000093'). Used for cross-referencing with the Internet Movie Database.","type":"string"},"ContributorAttributeDataSource":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeDataSource","description":"Indicates the origin of the contributor's data. `originNexus` means the record was ingested from Origin Nexus and may be updated by automated sync jobs. `custom` means the record was created manually by the tenant and is not subject to automated overwrites.","type":"string","enum":["originNexus","custom"]},"BaseResourceAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBaseResourceAttributes","description":"Common timestamps present on all resource attribute objects. `created` is the ISO 8601 date-time when the resource was first created; `updated` is the date-time of the most recent modification.","type":"object","additionalProperties":false,"required":["created","updated"],"properties":{"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"}}},"ContributorAttributeStatus":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeStatus","description":"Lifecycle status of the contributor. `active` means the contributor is available for use. `pendingDeletion` means a delete job has been initiated and the contributor will be removed once all associated credits are cleaned up.","type":"string","enum":["active","pendingDeletion"]},"ContributorRelationships":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorRelationships","description":"JSON:API relationship links for a contributor resource. Currently contains the owning tenant relationship.","type":"object","properties":{"tenant":{"$ref":"#/components/schemas/TenantRelationship"}},"required":["tenant"],"additionalProperties":false},"TenantRelationship":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ITenantRelationship","description":"A relationship to a tenant","type":"object","properties":{"data":{"additionalProperties":false,"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"required":["id","type"]},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"LinksRelated":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ILinks","description":"A JSON:API links object with an absolute or relative 'related' link","type":"object","required":["related"],"properties":{"related":{"type":"string"}},"additionalProperties":false},"LinksSelf":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ILinksSelf","description":"A JSON:API links object with an absolute or relative 'self' link","type":"object","required":["self"],"properties":{"self":{"type":"string"}},"additionalProperties":false}}},"paths":{"/tenants/system/contributors/{contributorId}":{"get":{"summary":"Get a single system-owned contributor","operationId":"contributorFindOneSystemOwned","description":"Get a single system-owned contributor by ID.","tags":["Contributors"],"parameters":[{"name":"contributorId","description":"The ID of the contributor to retrieve","in":"path","required":true,"schema":{"type":"string"}},{"name":"tenantId","description":"The ID of the tenant to get the contributor for.","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContributorFindOneResponse"}}}}}}}}}
```

## Search for contributors

> Search for contributors. Tenants can search for their own contributors and system-owned contributors.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2264"},"tags":[{"name":"Contributors","description":"Manage contributors in the context of a tenant. Create and manage contributor records (people and organizations) for use in credits and metadata."}],"servers":[{"url":"{protocol}://{domain}/{basePath}","variables":{"protocol":{"enum":["http","https"],"default":"https"},"domain":{"default":"api.studio.fabricdata.com"},"basePath":{"default":"v1"}}}],"security":[{"jwt-apikey-authorizer":[]}],"components":{"securitySchemes":{"jwt-apikey-authorizer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"ContributorSearchRequest":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorSearchRequest","description":"Request body for searching contributors. Queries are expressed as a tree of condition groups combined with boolean operators (AND, OR, NOT). Each leaf condition targets a specific contributor field using a comparison operator and value. Nested groups allow for arbitrarily complex query logic.","type":"object","properties":{"meta":{"$ref":"#/components/schemas/WriteRequestMeta"},"data":{"type":"object","properties":{"type":{"type":"string","enum":["searchQueries"]},"attributes":{"type":"object","properties":{"group":{"$ref":"#/components/schemas/IContributorQueryGroup"}},"required":["group"],"additionalProperties":false}},"required":["type","attributes"],"additionalProperties":false}},"required":["data"],"additionalProperties":false,"definitions":{"IContributorOperator":{"type":"string","description":"The operator to use for a search condition. eq — exact match. ne — exact exclusion; a record with NO value for the field satisfies ne. contains — substring/token match. not_contains — negation of contains, with the same 'no value satisfies the negation' semantics as ne. starts_with — prefix match. lt/lte/gt/gte — numeric or date range comparisons. exists — field has any non-null value. not_exists — field is absent or null.","enum":["eq","ne","contains","not_contains","starts_with","lt","lte","gt","gte","exists","not_exists"]},"IContributorCondition":{"type":"object","properties":{"field":{"type":"string","enum":["id","name","gender","originRating","birthDate","birthName","originNexusId","imdbId","status","dataSource"]},"operator":{"$ref":"#/components/schemas/IContributorOperator"},"value":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}},"required":["field","operator"],"additionalProperties":false},"IContributorQueryGroup":{"type":"object","properties":{"operator":{"type":"string","enum":["AND","OR","NOT"]},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/IContributorCondition"}},"groups":{"type":"array","items":{"$ref":"#/components/schemas/IContributorQueryGroup"}}},"required":["operator"],"anyOf":[{"required":["conditions"]},{"required":["groups"]}],"additionalProperties":false}}},"WriteRequestMeta":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IWriteRequestMeta","description":"Optional audit metadata for a write request. `audit.source` is the issuing surface/channel (e.g. studio-web, mcp, api, system); `audit.reason` is a free-text justification. Both are optional and length-capped.","type":"object","additionalProperties":false,"properties":{"audit":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string","maxLength":64},"reason":{"type":"string","maxLength":256}}}}},"IContributorQueryGroup":{"type":"object","properties":{"operator":{"type":"string","enum":["AND","OR","NOT"]},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/IContributorCondition"}},"groups":{"type":"array","items":{"$ref":"#/components/schemas/IContributorQueryGroup"}}},"required":["operator"],"anyOf":[{"required":["conditions"]},{"required":["groups"]}],"additionalProperties":false},"IContributorCondition":{"type":"object","properties":{"field":{"type":"string","enum":["id","name","gender","originRating","birthDate","birthName","originNexusId","imdbId","status","dataSource"]},"operator":{"$ref":"#/components/schemas/IContributorOperator"},"value":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"boolean"}]}},"required":["field","operator"],"additionalProperties":false},"IContributorOperator":{"type":"string","description":"The operator to use for a search condition. eq — exact match. ne — exact exclusion; a record with NO value for the field satisfies ne. contains — substring/token match. not_contains — negation of contains, with the same 'no value satisfies the negation' semantics as ne. starts_with — prefix match. lt/lte/gt/gte — numeric or date range comparisons. exists — field has any non-null value. not_exists — field is absent or null.","enum":["eq","ne","contains","not_contains","starts_with","lt","lte","gt","gte","exists","not_exists"]},"ContributorSearchResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorSearchResponse","description":"Response returned by the contributor search endpoint. Contains a paginated array of JSON:API contributor resources with their search-indexed attributes and relationships. The `meta` object includes pagination details (total count, current page, per-page size) and optional relevance scoring metadata.","type":"object","properties":{"data":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/ContributorResourceType"},{"type":"object","required":["id","attributes","relationships"],"additionalProperties":false,"properties":{"id":{"type":"string"},"attributes":{"$ref":"#/components/schemas/ContributorAttributesOpenSearchResponse"},"relationships":{"$ref":"#/components/schemas/ContributorRelationships"}}}],"additionalProperties":false},"additionalProperties":false},"links":{"type":"object","properties":{"self":{"type":"string"},"next":{"type":["string","null"]},"prev":{"type":["string","null"]}},"additionalProperties":false},"meta":{"type":"object","properties":{"total":{"type":"integer"},"page":{"type":"integer"},"perPage":{"type":"integer"},"openSearch":{"type":"object","additionalProperties":false,"properties":{"_id":{"type":"string"},"_index":{"type":"string"},"_score":{"type":"number"}}}},"required":["total","page","perPage"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false},"ContributorResourceType":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorResourceType","description":"JSON:API type discriminator for contributor resources. The `type` field is always `\"contributors\"`. Used as a base for contributor request and response shapes to enforce correct JSON:API resource typing.","type":"object","required":["type"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","enum":["contributors"]}}},"ContributorAttributesOpenSearchResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributesOpenSearchResponse","description":"Contributor attribute fields returned in search results. Contains the core contributor metadata fields (name, gender, dates, identifiers, status) as indexed by the search engine. Used as the `attributes` object within each search result item.","allOf":[{"type":"object","required":["name","status","dataSource"],"additionalProperties":false,"properties":{"name":{"$ref":"#/components/schemas/ContributorAttributeName"},"gender":{"$ref":"#/components/schemas/ContributorAttributeGender"},"originRating":{"$ref":"#/components/schemas/ContributorAttributeOriginRating"},"birthDate":{"$ref":"#/components/schemas/ContributorAttributeBirthDate"},"birthName":{"$ref":"#/components/schemas/ContributorAttributeBirthName"},"originNexusId":{"$ref":"#/components/schemas/ContributorAttributeOriginNexusId"},"imdbId":{"$ref":"#/components/schemas/ContributorAttributeImdbId"},"status":{"$ref":"#/components/schemas/ContributorAttributeStatus"},"dataSource":{"$ref":"#/components/schemas/ContributorAttributeDataSource"},"image":{"$ref":"#/components/schemas/ContributorAttributeImage"}}}]},"ContributorAttributeName":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeName","description":"The contributor's display name. For most contributors this is their full name (e.g., 'John Doe'). Required when creating a contributor.","type":"string"},"ContributorAttributeGender":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeGender","description":"The contributor's gender. Sourced from the external metadata provider when the contributor originates from Origin.","type":"string","enum":["male","female"]},"ContributorAttributeOriginRating":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeOriginRating","description":"A normalized popularity or relevance score for the contributor as provided by the Origin metadata provider. Higher values indicate greater prominence.","type":"number"},"ContributorAttributeBirthDate":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeBirthDate","description":"The contributor's date of birth. Stored as a string to accommodate partial dates (year-only or year-month) as well as full ISO 8601 dates.","type":"string"},"ContributorAttributeBirthName":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeBirthName","description":"The contributor's birth name or legal name, if different from their primary display name (e.g., a stage name or alias is used as the primary name).","type":"string"},"ContributorAttributeOriginNexusId":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeOriginNexusId","description":"The contributor's unique identifier in Origin Nexus. Used to link Origin Studio contributors to their corresponding Origin Nexus records and to sync updates.","type":"string"},"ContributorAttributeImdbId":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeImdbId","description":"The contributor's IMDb person ID (e.g., 'nm0000093'). Used for cross-referencing with the Internet Movie Database.","type":"string"},"ContributorAttributeStatus":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeStatus","description":"Lifecycle status of the contributor. `active` means the contributor is available for use. `pendingDeletion` means a delete job has been initiated and the contributor will be removed once all associated credits are cleaned up.","type":"string","enum":["active","pendingDeletion"]},"ContributorAttributeDataSource":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeDataSource","description":"Indicates the origin of the contributor's data. `originNexus` means the record was ingested from Origin Nexus and may be updated by automated sync jobs. `custom` means the record was created manually by the tenant and is not subject to automated overwrites.","type":"string","enum":["originNexus","custom"]},"ContributorAttributeImage":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorAttributeImage","description":"A profile image for the contributor. Contains the image URL and its pixel dimensions.","type":"object","required":["url","width","height"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"The fully qualified URL of the profile image."},"width":{"type":"number","description":"The image width in pixels."},"height":{"type":"number","description":"The image height in pixels."}}},"ContributorRelationships":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorRelationships","description":"JSON:API relationship links for a contributor resource. Currently contains the owning tenant relationship.","type":"object","properties":{"tenant":{"$ref":"#/components/schemas/TenantRelationship"}},"required":["tenant"],"additionalProperties":false},"TenantRelationship":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ITenantRelationship","description":"A relationship to a tenant","type":"object","properties":{"data":{"additionalProperties":false,"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"required":["id","type"]},"links":{"$ref":"#/components/schemas/LinksRelated"}},"required":["data","links"],"additionalProperties":false},"LinksRelated":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ILinks","description":"A JSON:API links object with an absolute or relative 'related' link","type":"object","required":["related"],"properties":{"related":{"type":"string"}},"additionalProperties":false}}},"paths":{"/contributors/search":{"post":{"summary":"Search for contributors","operationId":"searchContributors","description":"Search for contributors. Tenants can search for their own contributors and system-owned contributors.","tags":["Contributors"],"parameters":[{"name":"page.size","description":"The number of results to return per page, default is 50","in":"query","required":false,"schema":{"type":"integer","default":50}},{"name":"page.number","description":"The page number to return, default is 0","in":"query","required":false,"schema":{"type":"integer","default":0}},{"name":"sort","description":"Comma-separated list of fields to sort by. Use '-' prefix for descending order","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContributorSearchRequest"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContributorSearchResponse"}}}}}}}}}
```

## Create a single contributor job

> Create a single contributor job.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2264"},"tags":[{"name":"Contributors","description":"Manage contributors in the context of a tenant. Create and manage contributor records (people and organizations) for use in credits and metadata."}],"servers":[{"url":"{protocol}://{domain}/{basePath}","variables":{"protocol":{"enum":["http","https"],"default":"https"},"domain":{"default":"api.studio.fabricdata.com"},"basePath":{"default":"v1"}}}],"security":[{"jwt-apikey-authorizer":[]}],"components":{"securitySchemes":{"jwt-apikey-authorizer":{"type":"apiKey","name":"Authorization","in":"header"}},"schemas":{"ContributorJobCreateOneRequest":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorJobCreateOneRequest","description":"Request body for creating a new contributor background job. Currently supports only the `deleteContributor` job type, which accepts the target contributor's ID as a parameter.","type":"object","properties":{"meta":{"$ref":"#/components/schemas/WriteRequestMeta"},"data":{"allOf":[{"$ref":"#/components/schemas/BaseCreateRequest"},{"type":"object","properties":{"attributes":{"type":"object","properties":{"type":{"type":"string","enum":["deleteContributor"]},"parameters":{"$ref":"#/components/schemas/ContributorDeleteJobParameters"}},"required":["type","parameters"],"additionalProperties":false}},"required":["attributes"],"additionalProperties":false}]}},"required":["data"],"additionalProperties":false},"WriteRequestMeta":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IWriteRequestMeta","description":"Optional audit metadata for a write request. `audit.source` is the issuing surface/channel (e.g. studio-web, mcp, api, system); `audit.reason` is a free-text justification. Both are optional and length-capped.","type":"object","additionalProperties":false,"properties":{"audit":{"type":"object","additionalProperties":false,"properties":{"source":{"type":"string","maxLength":64},"reason":{"type":"string","maxLength":256}}}}},"BaseCreateRequest":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBaseCreateRequest","description":"Base JSON:API shape for create requests. The `type` field is required and must match the target resource type. The `id` field is optional; if omitted, the server generates a unique ID for the new resource.","type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string"}},"required":["type"]},"ContributorDeleteJobParameters":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorDeleteJobParameters","description":"Parameters for the `deleteContributor` background job. Specifies the unique ID of the contributor to be permanently deleted along with all associated credits.","type":"object","properties":{"contributorId":{"type":"string"}},"required":["contributorId"],"additionalProperties":false},"ContributorJobCreateOneResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorJobCreateOneResponse","description":"Response returned after successfully creating a contributor background job. Contains the new job's ID and its initial attributes (status, ARN, type, parameters). Poll the job status using the returned ID.","type":"object","properties":{"data":{"allOf":[{"$ref":"#/components/schemas/BaseCreateRequest"},{"additionalProperties":false,"properties":{"id":{"type":"string"},"attributes":{"$ref":"#/components/schemas/ContributorJobAttributes"}},"required":["id","attributes"]}]}},"required":["data"],"additionalProperties":false},"ContributorJobAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IContributorJobAttributes","description":"Attributes of a contributor background job. Currently the only supported job type is `deleteContributor`, which asynchronously removes a contributor and all associated credit records. Extends base background job attributes with job type and parameters.","type":"object","allOf":[{"$ref":"#/components/schemas/BackgroundJobAttributes"},{"type":"object","properties":{"type":{"type":"string","enum":["deleteContributor"]},"parameters":{"type":"object","properties":{"contributorId":{"type":"string","description":"The ID of the contributor being deleted."},"tenantId":{"type":"string","description":"The ID of the tenant that owns the contributor."},"subject":{"type":"string","description":"Human-readable label for the job's target contributor (its name), captured server-side at job creation so the UI can display it even after the contributor is deleted. Purely presentational — not used by job processing."}},"required":["contributorId","tenantId"],"additionalProperties":false}},"required":["type","parameters"],"additionalProperties":false}],"required":["status","created","updated","type","parameters"],"additionalProperties":false},"BackgroundJobAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBackgroundJobAttributes","description":"Attributes for a background job. Background jobs represent long-running asynchronous operations (e.g. contributor deletion, tenant data export). Includes current status, job type, parameters, optional output on completion, optional error details on failure, and optional item progress counts for batch jobs.","type":"object","allOf":[{"$ref":"#/components/schemas/BaseResourceAttributes"},{"type":"object","properties":{"type":{"type":"string"},"parameters":{"type":"object"},"status":{"$ref":"#/components/schemas/BackgroundJobStatus"},"output":{"type":"object"},"totalItemsCount":{"type":"integer","minimum":0,"description":"Total number of items in a batch job, when applicable."},"successItemsCount":{"type":"integer","minimum":0,"description":"Number of items processed successfully in a batch job, when applicable."},"failedItemsCount":{"type":"integer","minimum":0,"description":"Number of items that failed in a batch job, when applicable."},"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"}},"required":["message","code"],"additionalProperties":false}},"required":["type","parameters","status"],"additionalProperties":false}],"additionalProperties":false},"BaseResourceAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBaseResourceAttributes","description":"Common timestamps present on all resource attribute objects. `created` is the ISO 8601 date-time when the resource was first created; `updated` is the date-time of the most recent modification.","type":"object","additionalProperties":false,"required":["created","updated"],"properties":{"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"}}},"BackgroundJobStatus":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IBackgroundJobStatus","description":"Status of a background job: ABORTED, FAILED, PENDING_REDRIVE, RUNNING, SUCCEEDED, or TIMED_OUT.","type":"string","enum":["ABORTED","FAILED","PENDING_REDRIVE","RUNNING","SUCCEEDED","TIMED_OUT"]}}},"paths":{"/contributors/jobs":{"post":{"summary":"Create a single contributor job","operationId":"contributorJobCreateOne","description":"Create a single contributor job.","tags":["Contributors"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContributorJobCreateOneRequest"}}}},"responses":{"201":{"description":"Created OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContributorJobCreateOneResponse"}}}}}}}}}
```