> 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.2817"},"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":"Audit metadata for a write request. `audit.source` names the surface that sent it, such as `studio-web`, `studio-mcp`, `api` or `system`; `audit.reason` is a free-text justification.","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","jsonapi"],"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"}}}]},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"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":"Timestamps on every resource's attributes, as ISO 8601 date-times. `created` marks the resource's creation; `updated` marks its last change.","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},"JsonApiVersion":{"type":"object","description":"The JSON:API version this document conforms to.","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"The body of a failed request: an `errors` array with one or more error objects.","type":"object","required":["errors","jsonapi"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"One JSON:API error object. `status` is the HTTP status code as a string, `title` a short summary and `detail` optional context. `meta` can carry structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","description":"A stable code for the problem that you can act on, when the operation documents one."},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error, such as `/data/attributes/title`.","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"The error's stack trace. Non-production environments only."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}}}},"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"}}}},"400":{"description":"- The body fails validation.\n- A query parameter is unknown or has an invalid value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not allowed to create contributors in this tenant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"- A contributor with this `data.id` or `originNexusId` exists.\n- `data.type` is not `contributors`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## 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.2817"},"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","jsonapi"],"properties":{"data":{"type":"object","required":["id","type","attributes","relationships"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","const":"contributors"},"attributes":{"$ref":"#/components/schemas/ContributorAttributes"},"relationships":{"$ref":"#/components/schemas/ContributorRelationships"}}},"links":{"$ref":"#/components/schemas/LinksSelf"},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"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":"Timestamps on every resource's attributes, as ISO 8601 date-times. `created` marks the resource's creation; `updated` marks its last change.","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},"JsonApiVersion":{"type":"object","description":"The JSON:API version this document conforms to.","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"The body of a failed request: an `errors` array with one or more error objects.","type":"object","required":["errors","jsonapi"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"One JSON:API error object. `status` is the HTTP status code as a string, `title` a short summary and `detail` optional context. `meta` can carry structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","description":"A stable code for the problem that you can act on, when the operation documents one."},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error, such as `/data/attributes/title`.","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"The error's stack trace. Non-production environments only."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}}}},"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"}}}},"400":{"description":"This operation accepts no query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not allowed to read this contributor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"The contributor does not exist in this tenant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## 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.2817"},"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":"Updates the attributes you send and leaves the rest unchanged. Set `data.type` to `contributors` and `data.id` to the contributor in the URL.","type":"object","properties":{"meta":{"$ref":"#/components/schemas/WriteRequestMeta"},"data":{"allOf":[{"$ref":"#/components/schemas/ContributorResourceType"},{"type":"object","required":["id","attributes"],"additionalProperties":false,"properties":{"id":{"type":"string"},"attributes":{"$ref":"#/components/schemas/ContributorAttributesInput"}}}]}},"required":["data"],"additionalProperties":false},"WriteRequestMeta":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IWriteRequestMeta","description":"Audit metadata for a write request. `audit.source` names the surface that sent it, such as `studio-web`, `studio-mcp`, `api` or `system`; `audit.reason` is a free-text justification.","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"]},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"The body of a failed request: an `errors` array with one or more error objects.","type":"object","required":["errors","jsonapi"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"One JSON:API error object. `status` is the HTTP status code as a string, `title` a short summary and `detail` optional context. `meta` can carry structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","description":"A stable code for the problem that you can act on, when the operation documents one."},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error, such as `/data/attributes/title`.","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"The error's stack trace. Non-production environments only."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}},"JsonApiVersion":{"type":"object","description":"The JSON:API version this document conforms to.","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false}}},"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":{}}},"400":{"description":"- The body fails validation or has no `data.id`.\n- The request has a query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not allowed to update this contributor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"The contributor does not exist in this tenant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"- `data.id` names a different contributor than the URL.\n- `data.type` is not `contributors`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## 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.2817"},"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","jsonapi"],"properties":{"data":{"type":"object","required":["id","type","attributes","relationships"],"additionalProperties":false,"properties":{"id":{"type":"string"},"type":{"type":"string","const":"contributors"},"attributes":{"$ref":"#/components/schemas/ContributorAttributes"},"relationships":{"$ref":"#/components/schemas/ContributorRelationships"}}},"links":{"$ref":"#/components/schemas/LinksSelf"},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"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":"Timestamps on every resource's attributes, as ISO 8601 date-times. `created` marks the resource's creation; `updated` marks its last change.","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},"JsonApiVersion":{"type":"object","description":"The JSON:API version this document conforms to.","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"The body of a failed request: an `errors` array with one or more error objects.","type":"object","required":["errors","jsonapi"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"One JSON:API error object. `status` is the HTTP status code as a string, `title` a short summary and `detail` optional context. `meta` can carry structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","description":"A stable code for the problem that you can act on, when the operation documents one."},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error, such as `/data/attributes/title`.","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"The error's stack trace. Non-production environments only."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}}}},"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"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContributorFindOneResponse"}}}},"400":{"description":"This operation accepts no query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No system contributor has this id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## 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.2817"},"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"}]},"fuzzy":{"type":"boolean","description":"Typo tolerance for `contains` and `not_contains` on `name`.\n- Omitted or `true`: a word one or two characters off still matches (\"smyth\" finds \"Smith\").\n- `false`: the words must match exactly."}},"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":"Audit metadata for a write request. `audit.source` names the surface that sent it, such as `studio-web`, `studio-mcp`, `api` or `system`; `audit.reason` is a free-text justification.","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"}]},"fuzzy":{"type":"boolean","description":"Typo tolerance for `contains` and `not_contains` on `name`.\n- Omitted or `true`: a word one or two characters off still matches (\"smyth\" finds \"Smith\").\n- `false`: the words must match exactly."}},"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"},"sort":{"$ref":"#/components/schemas/SearchSortMeta"}},"required":["total","page","perPage"],"additionalProperties":false},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}},"required":["data","meta","jsonapi"],"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},"SearchSortMeta":{"$schema":"http://json-schema.org/draft-07/schema#","title":"ISearchSortMeta","description":"The ordering applied to the search results. Every search response carries it, whether or not the request asked for an ordering.","type":"object","properties":{"applied":{"type":"string","description":"The ordering applied, in the `sort` parameter's comma-separated syntax. Pass it back as `sort` to keep the ordering fixed across later requests."},"default":{"type":"boolean","description":"`true` when the request had no `sort` and the server chose the ordering; `false` when it reflects the `sort` you sent."}},"required":["applied","default"],"additionalProperties":false},"JsonApiVersion":{"type":"object","description":"The JSON:API version this document conforms to.","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"The body of a failed request: an `errors` array with one or more error objects.","type":"object","required":["errors","jsonapi"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"One JSON:API error object. `status` is the HTTP status code as a string, `title` a short summary and `detail` optional context. `meta` can carry structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","description":"A stable code for the problem that you can act on, when the operation documents one."},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error, such as `/data/attributes/title`.","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"The error's stack trace. Non-production environments only."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}}}},"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. An explicit sort replaces the default ordering entirely rather than extending it. Results are always ordered: when this is omitted they are ranked by how well each contributor matches the query, then by descending originRating, updated and created. Whatever ordering was applied is reported on `meta.sort`.","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"}}}},"400":{"description":"- The body fails validation.\n- A query parameter is unknown or has an invalid value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Create a single contributor job

> Create a single contributor job.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2817"},"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":"Audit metadata for a write request. `audit.source` names the surface that sent it, such as `studio-web`, `studio-mcp`, `api` or `system`; `audit.reason` is a free-text justification.","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 shape for create requests. `type` must match the target resource type. Omit `id` to let the server generate one.","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"]}]},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}},"required":["data","jsonapi"],"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 of a background job, a long-running operation such as a contributor delete or tenant data export. They carry the status, job type and parameters, plus the output on completion, error details on failure, and item 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","properties":{"errorsAvailable":{"type":"boolean","description":"True when GET /backgroundJobs/{jobId}/errors can download the job's per-item error files."}}},"totalItemsCount":{"type":"integer","minimum":0,"description":"Total items in a batch job, when applicable."},"successItemsCount":{"type":"integer","minimum":0,"description":"Items the batch job processed successfully, when applicable."},"failedItemsCount":{"type":"integer","minimum":0,"description":"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":"Timestamps on every resource's attributes, as ISO 8601 date-times. `created` marks the resource's creation; `updated` marks its last change.","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":"A background job's status. `RUNNING` and `PENDING_REDRIVE` (queued for retry) are still in progress; `SUCCEEDED`, `FAILED`, `TIMED_OUT` and `ABORTED` are final.","type":"string","enum":["ABORTED","FAILED","PENDING_REDRIVE","RUNNING","SUCCEEDED","TIMED_OUT"]},"JsonApiVersion":{"type":"object","description":"The JSON:API version this document conforms to.","properties":{"version":{"type":"string"}},"required":["version"],"additionalProperties":false},"ErrorResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IErrorResponse","description":"The body of a failed request: an `errors` array with one or more error objects.","type":"object","required":["errors","jsonapi"],"additionalProperties":false,"properties":{"errors":{"type":"array","items":{"$ref":"#/components/schemas/Error"}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}}},"Error":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IError","description":"One JSON:API error object. `status` is the HTTP status code as a string, `title` a short summary and `detail` optional context. `meta` can carry structured conflict or authorization details.","type":"object","additionalProperties":false,"required":["status","title"],"properties":{"status":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","description":"A stable code for the problem that you can act on, when the operation documents one."},"detail":{"type":"string"},"source":{"type":"object","description":"A JSON Pointer to the request field that caused the error, such as `/data/attributes/title`.","properties":{"pointer":{"type":"string"}}},"meta":{"type":"object","additionalProperties":true,"properties":{"stack":{"type":"string","description":"The error's stack trace. Non-production environments only."},"conflictItems":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}},"unauthorizedItems":{"type":"array","items":{"type":"string"}}}}}}}},"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"}}}},"400":{"description":"- The body fails validation.\n- The request has a query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Not allowed to delete this contributor.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"The contributor does not exist in this tenant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
