> 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/record-lifecycles.md).

# Record Lifecycles

Manage a tenant's record lifecycles. A lifecycle defines the statuses (nodes) a record of one `workType` can hold, such as Draft, In Review and Published, and the transitions (edges) allowed between them.

## List record lifecycles

> List the tenant's record lifecycles.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2817"},"tags":[{"name":"Record Lifecycles","description":"Manage a tenant's record lifecycles. A lifecycle defines the statuses (nodes) a record of one `workType` can hold, such as Draft, In Review and Published, and the transitions (edges) allowed between them."}],"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":{"RecordLifecycleFindManyResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleFindManyResponse","description":"Every record lifecycle in the tenant, with its full graph.","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the lifecycle"},"type":{"type":"string","enum":["recordLifecycles"]},"attributes":{"allOf":[{"$ref":"#/components/schemas/BaseResourceAttributes"},{"$ref":"#/components/schemas/RecordLifecycleAttributes"}]},"relationships":{"type":"object","properties":{"tenant":{"description":"The tenant that owns this lifecycle definition.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"required":["id","type"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},"author":{"description":"The user who originally created this lifecycle definition.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["users"]},"meta":{"type":"object","properties":{"tenantId":{"type":"string"},"type":{"type":"string"},"displayName":{"type":"string"}},"required":["tenantId","type","displayName"]}},"required":["id","type","meta"]},"links":{"type":"object","properties":{"related":{"type":"string"}}}},"required":["data"]},"updatedBy":{"description":"The user who last modified this lifecycle definition.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["users"]},"meta":{"type":"object","properties":{"tenantId":{"type":"string"},"type":{"type":"string"},"displayName":{"type":"string"}},"required":["tenantId","type","displayName"]}},"required":["id","type","meta"]},"links":{"type":"object","properties":{"related":{"type":"string"}}}},"required":["data"]}},"required":["tenant"],"additionalProperties":false}},"required":["id","type","attributes","relationships"],"additionalProperties":false}},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}},"required":["data","jsonapi"],"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"}}},"RecordLifecycleAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleAttributes","description":"Attributes defining a record lifecycle: work type, statuses, and transitions between statuses.","type":"object","required":["workType","statuses","transitions"],"additionalProperties":false,"properties":{"workType":{"$ref":"#/components/schemas/WorkTypes"},"statuses":{"type":"array","description":"The lifecycle statuses","items":{"$ref":"#/components/schemas/RecordLifecycleNodeAttributes"}},"transitions":{"type":"array","description":"The lifecycle transitions between statuses","items":{"$ref":"#/components/schemas/RecordLifecycleEdgeAttributes"}}}},"WorkTypes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"WorkTypes","description":"The key of one of the tenant's work types. Every tenant has seven built-in work types:\n- `Movie`: a standalone feature-length film\n- `MovieEdit`: a variation of a Movie\n- `Series`: a TV or streaming series\n- `Season`: a season within a Series\n- `Episode`: a single episode\n- `EpisodeEdit`: a variation of an Episode\n- `Compilation`: an editorially curated collection of existing records\n\nTenants can also define custom work types; list them with `GET /workTypes`.","type":"string","pattern":"^[A-Z][A-Za-z0-9]{1,39}$"},"RecordLifecycleNodeAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleStatusAttributes","description":"A single lifecycle status node: id, label, phase (drafting or published), and optional position.","type":"object","required":["id","label","phase"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Unique identifier for the status"},"label":{"type":"string","description":"Display label for the status"},"phase":{"type":"string","enum":["drafting","published"],"description":"The phase this status belongs to"},"description":{"type":"string","description":"Optional description of the status"},"positionX":{"type":"number","description":"The x position of the status"},"positionY":{"type":"number","description":"The y position of the status"}}},"RecordLifecycleEdgeAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleTransitionAttributes","description":"A transition in the lifecycle graph, from status `fromStatusId` to status `toStatusId`.","type":"object","required":["id","label","fromStatusId","toStatusId","direction"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Unique identifier for the transition"},"label":{"type":"string","description":"Display label for the transition action"},"fromStatusId":{"type":"string","description":"The source status ID"},"toStatusId":{"type":"string","description":"The target status ID"},"direction":{"type":"string","enum":["forward","backward"],"description":"Whether the transition moves the record on or back.\n- `forward`: progresses the lifecycle.\n- `backward`: regresses it.\n\nThe lifecycle editor sets it from the edge handles: east to west is `forward`."},"description":{"type":"string","description":"Optional description for the transition action"}}},"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":{"/recordLifecycles":{"get":{"summary":"List record lifecycles","operationId":"recordLifecycleFindMany","description":"List the tenant's record lifecycles.","tags":["Record Lifecycles"],"parameters":[{"name":"filter.workType","description":"Return only lifecycles for this `workType`.","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Lifecycles.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordLifecycleFindManyResponse"}}}},"400":{"description":"An unknown query parameter, or an invalid value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Create a record lifecycle

> Create a record lifecycle for one \`workType\`.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2817"},"tags":[{"name":"Record Lifecycles","description":"Manage a tenant's record lifecycles. A lifecycle defines the statuses (nodes) a record of one `workType` can hold, such as Draft, In Review and Published, and the transitions (edges) allowed between them."}],"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":{"RecordLifecycleCreateRequest":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleCreateRequest","description":"Creates a record lifecycle: its statuses, allowed transitions, and each status's position in the lifecycle editor.","type":"object","properties":{"meta":{"$ref":"#/components/schemas/WriteRequestMeta"},"data":{"type":"object","properties":{"type":{"type":"string","enum":["recordLifecycles"]},"attributes":{"$ref":"#/components/schemas/RecordLifecycleAttributes"}},"required":["type","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}}}}},"RecordLifecycleAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleAttributes","description":"Attributes defining a record lifecycle: work type, statuses, and transitions between statuses.","type":"object","required":["workType","statuses","transitions"],"additionalProperties":false,"properties":{"workType":{"$ref":"#/components/schemas/WorkTypes"},"statuses":{"type":"array","description":"The lifecycle statuses","items":{"$ref":"#/components/schemas/RecordLifecycleNodeAttributes"}},"transitions":{"type":"array","description":"The lifecycle transitions between statuses","items":{"$ref":"#/components/schemas/RecordLifecycleEdgeAttributes"}}}},"WorkTypes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"WorkTypes","description":"The key of one of the tenant's work types. Every tenant has seven built-in work types:\n- `Movie`: a standalone feature-length film\n- `MovieEdit`: a variation of a Movie\n- `Series`: a TV or streaming series\n- `Season`: a season within a Series\n- `Episode`: a single episode\n- `EpisodeEdit`: a variation of an Episode\n- `Compilation`: an editorially curated collection of existing records\n\nTenants can also define custom work types; list them with `GET /workTypes`.","type":"string","pattern":"^[A-Z][A-Za-z0-9]{1,39}$"},"RecordLifecycleNodeAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleStatusAttributes","description":"A single lifecycle status node: id, label, phase (drafting or published), and optional position.","type":"object","required":["id","label","phase"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Unique identifier for the status"},"label":{"type":"string","description":"Display label for the status"},"phase":{"type":"string","enum":["drafting","published"],"description":"The phase this status belongs to"},"description":{"type":"string","description":"Optional description of the status"},"positionX":{"type":"number","description":"The x position of the status"},"positionY":{"type":"number","description":"The y position of the status"}}},"RecordLifecycleEdgeAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleTransitionAttributes","description":"A transition in the lifecycle graph, from status `fromStatusId` to status `toStatusId`.","type":"object","required":["id","label","fromStatusId","toStatusId","direction"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Unique identifier for the transition"},"label":{"type":"string","description":"Display label for the transition action"},"fromStatusId":{"type":"string","description":"The source status ID"},"toStatusId":{"type":"string","description":"The target status ID"},"direction":{"type":"string","enum":["forward","backward"],"description":"Whether the transition moves the record on or back.\n- `forward`: progresses the lifecycle.\n- `backward`: regresses it.\n\nThe lifecycle editor sets it from the edge handles: east to west is `forward`."},"description":{"type":"string","description":"Optional description for the transition action"}}},"RecordLifecycleFindOneResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleFindOneResponse","description":"One record lifecycle with its full graph: statuses, transitions, nodes and edges.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the lifecycle"},"type":{"type":"string","enum":["recordLifecycles"]},"attributes":{"allOf":[{"$ref":"#/components/schemas/BaseResourceAttributes"},{"$ref":"#/components/schemas/RecordLifecycleAttributes"}]},"relationships":{"type":"object","properties":{"tenant":{"description":"The tenant that owns this lifecycle definition.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"required":["id","type"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},"author":{"description":"The user who originally created this lifecycle definition.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["users"]},"meta":{"type":"object","properties":{"tenantId":{"type":"string"},"type":{"type":"string"},"displayName":{"type":"string"}},"required":["tenantId","type","displayName"]}},"required":["id","type","meta"]},"links":{"type":"object","properties":{"related":{"type":"string"}}}},"required":["data"]},"updatedBy":{"description":"The user who last modified this lifecycle definition.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["users"]},"meta":{"type":"object","properties":{"tenantId":{"type":"string"},"type":{"type":"string"},"displayName":{"type":"string"}},"required":["tenantId","type","displayName"]}},"required":["id","type","meta"]},"links":{"type":"object","properties":{"related":{"type":"string"}}}},"required":["data"]}},"required":["tenant"],"additionalProperties":false}},"required":["id","type","attributes","relationships"],"additionalProperties":false},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}},"required":["data","jsonapi"],"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"}}},"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":{"/recordLifecycles":{"post":{"summary":"Create a record lifecycle","operationId":"recordLifecycleCreateOne","description":"Create a record lifecycle for one `workType`.","tags":["Record Lifecycles"],"parameters":[{"name":"tenantId","description":"Tenant to create the lifecycle in. Defaults to the caller's tenant.","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"description":"The full lifecycle: statuses, transitions and metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordLifecycleCreateRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordLifecycleFindOneResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Get a record lifecycle

> Get one record lifecycle by id.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2817"},"tags":[{"name":"Record Lifecycles","description":"Manage a tenant's record lifecycles. A lifecycle defines the statuses (nodes) a record of one `workType` can hold, such as Draft, In Review and Published, and the transitions (edges) allowed between them."}],"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":{"RecordLifecycleFindOneResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleFindOneResponse","description":"One record lifecycle with its full graph: statuses, transitions, nodes and edges.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the lifecycle"},"type":{"type":"string","enum":["recordLifecycles"]},"attributes":{"allOf":[{"$ref":"#/components/schemas/BaseResourceAttributes"},{"$ref":"#/components/schemas/RecordLifecycleAttributes"}]},"relationships":{"type":"object","properties":{"tenant":{"description":"The tenant that owns this lifecycle definition.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"required":["id","type"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},"author":{"description":"The user who originally created this lifecycle definition.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["users"]},"meta":{"type":"object","properties":{"tenantId":{"type":"string"},"type":{"type":"string"},"displayName":{"type":"string"}},"required":["tenantId","type","displayName"]}},"required":["id","type","meta"]},"links":{"type":"object","properties":{"related":{"type":"string"}}}},"required":["data"]},"updatedBy":{"description":"The user who last modified this lifecycle definition.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["users"]},"meta":{"type":"object","properties":{"tenantId":{"type":"string"},"type":{"type":"string"},"displayName":{"type":"string"}},"required":["tenantId","type","displayName"]}},"required":["id","type","meta"]},"links":{"type":"object","properties":{"related":{"type":"string"}}}},"required":["data"]}},"required":["tenant"],"additionalProperties":false}},"required":["id","type","attributes","relationships"],"additionalProperties":false},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}},"required":["data","jsonapi"],"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"}}},"RecordLifecycleAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleAttributes","description":"Attributes defining a record lifecycle: work type, statuses, and transitions between statuses.","type":"object","required":["workType","statuses","transitions"],"additionalProperties":false,"properties":{"workType":{"$ref":"#/components/schemas/WorkTypes"},"statuses":{"type":"array","description":"The lifecycle statuses","items":{"$ref":"#/components/schemas/RecordLifecycleNodeAttributes"}},"transitions":{"type":"array","description":"The lifecycle transitions between statuses","items":{"$ref":"#/components/schemas/RecordLifecycleEdgeAttributes"}}}},"WorkTypes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"WorkTypes","description":"The key of one of the tenant's work types. Every tenant has seven built-in work types:\n- `Movie`: a standalone feature-length film\n- `MovieEdit`: a variation of a Movie\n- `Series`: a TV or streaming series\n- `Season`: a season within a Series\n- `Episode`: a single episode\n- `EpisodeEdit`: a variation of an Episode\n- `Compilation`: an editorially curated collection of existing records\n\nTenants can also define custom work types; list them with `GET /workTypes`.","type":"string","pattern":"^[A-Z][A-Za-z0-9]{1,39}$"},"RecordLifecycleNodeAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleStatusAttributes","description":"A single lifecycle status node: id, label, phase (drafting or published), and optional position.","type":"object","required":["id","label","phase"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Unique identifier for the status"},"label":{"type":"string","description":"Display label for the status"},"phase":{"type":"string","enum":["drafting","published"],"description":"The phase this status belongs to"},"description":{"type":"string","description":"Optional description of the status"},"positionX":{"type":"number","description":"The x position of the status"},"positionY":{"type":"number","description":"The y position of the status"}}},"RecordLifecycleEdgeAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleTransitionAttributes","description":"A transition in the lifecycle graph, from status `fromStatusId` to status `toStatusId`.","type":"object","required":["id","label","fromStatusId","toStatusId","direction"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Unique identifier for the transition"},"label":{"type":"string","description":"Display label for the transition action"},"fromStatusId":{"type":"string","description":"The source status ID"},"toStatusId":{"type":"string","description":"The target status ID"},"direction":{"type":"string","enum":["forward","backward"],"description":"Whether the transition moves the record on or back.\n- `forward`: progresses the lifecycle.\n- `backward`: regresses it.\n\nThe lifecycle editor sets it from the edge handles: east to west is `forward`."},"description":{"type":"string","description":"Optional description for the transition action"}}},"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":{"/recordLifecycles/{recordLifecycleId}":{"get":{"summary":"Get a record lifecycle","operationId":"recordLifecycleFindOne","description":"Get one record lifecycle by id.","tags":["Record Lifecycles"],"parameters":[{"name":"recordLifecycleId","description":"The lifecycle to get.","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordLifecycleFindOneResponse"}}}},"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":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Delete a record lifecycle

> Delete a record lifecycle.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2817"},"tags":[{"name":"Record Lifecycles","description":"Manage a tenant's record lifecycles. A lifecycle defines the statuses (nodes) a record of one `workType` can hold, such as Draft, In Review and Published, and the transitions (edges) allowed between them."}],"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":{"WriteMetaOnlyRequest":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IWriteMetaOnlyRequest","description":"An optional body with only audit metadata, for mutations that take no other body, such as deletes. Use it to send `meta.audit.source` and `meta.audit.reason`.","type":"object","additionalProperties":false,"properties":{"meta":{"$ref":"#/components/schemas/WriteRequestMeta"}}},"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}}}}},"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":{"/recordLifecycles/{recordLifecycleId}":{"delete":{"summary":"Delete a record lifecycle","operationId":"recordLifecycleDeleteOne","requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WriteMetaOnlyRequest"}}}},"description":"Delete a record lifecycle.","tags":["Record Lifecycles"],"parameters":[{"name":"recordLifecycleId","description":"The lifecycle to delete.","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Lifecycle deleted."},"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":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```

## Update a record lifecycle

> Update a record lifecycle.

```json
{"openapi":"3.0.3","info":{"title":"Fabric API - Audit","version":"0.9.2817"},"tags":[{"name":"Record Lifecycles","description":"Manage a tenant's record lifecycles. A lifecycle defines the statuses (nodes) a record of one `workType` can hold, such as Draft, In Review and Published, and the transitions (edges) allowed between them."}],"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":{"RecordLifecycleUpdateRequest":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleUpdateRequest","description":"Updates a record lifecycle: only the fields sent change. Covers the statuses, transitions and status positions.","type":"object","properties":{"meta":{"$ref":"#/components/schemas/WriteRequestMeta"},"data":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the lifecycle"},"type":{"type":"string","enum":["recordLifecycles"]},"attributes":{"type":"object","additionalProperties":false,"properties":{"statuses":{"type":"array","description":"The lifecycle statuses","items":{"$ref":"#/components/schemas/RecordLifecycleStatusAttributes"}},"transitions":{"type":"array","description":"The lifecycle transitions","items":{"$ref":"#/components/schemas/RecordLifecycleTransitionAttributes"}}}}},"required":["id","type","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}}}}},"RecordLifecycleStatusAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleStatusAttributes","description":"A lifecycle status definition: id, label, phase (drafting or published), optional description and position, and in-use metadata.","type":"object","required":["id","label","phase"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Unique identifier for the status"},"label":{"type":"string","description":"Display label for the status"},"phase":{"type":"string","enum":["drafting","published"],"description":"The phase this status belongs to"},"description":{"type":"string","description":"Optional description for the status"},"positionX":{"type":"number","description":"The x position of the status"},"positionY":{"type":"number","description":"The y position of the status"},"meta":{"type":"object","description":"Metadata about the status","additionalProperties":false,"properties":{"inUse":{"type":"boolean","description":"Whether any record in the library has this status."}}}}},"RecordLifecycleTransitionAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleTransitionAttributes","description":"A lifecycle transition: the action that moves a record from one status to another.","type":"object","required":["id","label","fromStatusId","toStatusId","direction"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Unique identifier for the transition"},"label":{"type":"string","description":"Display label for the transition action"},"fromStatusId":{"type":"string","description":"The source status ID"},"toStatusId":{"type":"string","description":"The target status ID"},"direction":{"type":"string","enum":["forward","backward"],"description":"Whether the transition moves the record on or back.\n- `forward`: progresses the lifecycle.\n- `backward`: regresses it.\n\nThe lifecycle editor sets it from the edge handles: east to west is `forward`."}}},"RecordLifecycleFindOneResponse":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleFindOneResponse","description":"One record lifecycle with its full graph: statuses, transitions, nodes and edges.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the lifecycle"},"type":{"type":"string","enum":["recordLifecycles"]},"attributes":{"allOf":[{"$ref":"#/components/schemas/BaseResourceAttributes"},{"$ref":"#/components/schemas/RecordLifecycleAttributes"}]},"relationships":{"type":"object","properties":{"tenant":{"description":"The tenant that owns this lifecycle definition.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["tenants"]}},"required":["id","type"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},"author":{"description":"The user who originally created this lifecycle definition.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["users"]},"meta":{"type":"object","properties":{"tenantId":{"type":"string"},"type":{"type":"string"},"displayName":{"type":"string"}},"required":["tenantId","type","displayName"]}},"required":["id","type","meta"]},"links":{"type":"object","properties":{"related":{"type":"string"}}}},"required":["data"]},"updatedBy":{"description":"The user who last modified this lifecycle definition.","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["users"]},"meta":{"type":"object","properties":{"tenantId":{"type":"string"},"type":{"type":"string"},"displayName":{"type":"string"}},"required":["tenantId","type","displayName"]}},"required":["id","type","meta"]},"links":{"type":"object","properties":{"related":{"type":"string"}}}},"required":["data"]}},"required":["tenant"],"additionalProperties":false}},"required":["id","type","attributes","relationships"],"additionalProperties":false},"jsonapi":{"$ref":"#/components/schemas/JsonApiVersion"}},"required":["data","jsonapi"],"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"}}},"RecordLifecycleAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleAttributes","description":"Attributes defining a record lifecycle: work type, statuses, and transitions between statuses.","type":"object","required":["workType","statuses","transitions"],"additionalProperties":false,"properties":{"workType":{"$ref":"#/components/schemas/WorkTypes"},"statuses":{"type":"array","description":"The lifecycle statuses","items":{"$ref":"#/components/schemas/RecordLifecycleNodeAttributes"}},"transitions":{"type":"array","description":"The lifecycle transitions between statuses","items":{"$ref":"#/components/schemas/RecordLifecycleEdgeAttributes"}}}},"WorkTypes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"WorkTypes","description":"The key of one of the tenant's work types. Every tenant has seven built-in work types:\n- `Movie`: a standalone feature-length film\n- `MovieEdit`: a variation of a Movie\n- `Series`: a TV or streaming series\n- `Season`: a season within a Series\n- `Episode`: a single episode\n- `EpisodeEdit`: a variation of an Episode\n- `Compilation`: an editorially curated collection of existing records\n\nTenants can also define custom work types; list them with `GET /workTypes`.","type":"string","pattern":"^[A-Z][A-Za-z0-9]{1,39}$"},"RecordLifecycleNodeAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleStatusAttributes","description":"A single lifecycle status node: id, label, phase (drafting or published), and optional position.","type":"object","required":["id","label","phase"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Unique identifier for the status"},"label":{"type":"string","description":"Display label for the status"},"phase":{"type":"string","enum":["drafting","published"],"description":"The phase this status belongs to"},"description":{"type":"string","description":"Optional description of the status"},"positionX":{"type":"number","description":"The x position of the status"},"positionY":{"type":"number","description":"The y position of the status"}}},"RecordLifecycleEdgeAttributes":{"$schema":"http://json-schema.org/draft-07/schema#","title":"IRecordLifecycleTransitionAttributes","description":"A transition in the lifecycle graph, from status `fromStatusId` to status `toStatusId`.","type":"object","required":["id","label","fromStatusId","toStatusId","direction"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Unique identifier for the transition"},"label":{"type":"string","description":"Display label for the transition action"},"fromStatusId":{"type":"string","description":"The source status ID"},"toStatusId":{"type":"string","description":"The target status ID"},"direction":{"type":"string","enum":["forward","backward"],"description":"Whether the transition moves the record on or back.\n- `forward`: progresses the lifecycle.\n- `backward`: regresses it.\n\nThe lifecycle editor sets it from the edge handles: east to west is `forward`."},"description":{"type":"string","description":"Optional description for the transition action"}}},"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":{"/recordLifecycles/{recordLifecycleId}":{"patch":{"summary":"Update a record lifecycle","operationId":"recordLifecycleUpdateOne","description":"Update a record lifecycle.","tags":["Record Lifecycles"],"parameters":[{"name":"recordLifecycleId","description":"The lifecycle to update.","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Lifecycle fields to change, such as statuses, transitions or status metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordLifecycleUpdateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordLifecycleFindOneResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```
