> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reelevant.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Post contentsresourcesderive

> Derive an image with a named recipe and answer with the asset
it is stored under, so a caller that cannot run the recipe itself (a pod
without the matte model) can have the deployment holding it do the work and
then draw the result from the shared store.

Internal only: it derives an arbitrary url on demand, and the identity it
derives into is the `x-rlvt-company-id` of the internal request, so it is
refused without the internal secret rather than left to a user token.



## OpenAPI

````yaml https://openapi.production.reelevant.io/v1/render/contents-api post /contents/resources/derive
openapi: 3.0.0
info:
  title: contents-api
  version: d7f36a62e7f11bd9eac417febb66874ce051394a
  description: |-
    # Errors
    | Error code | Message | HTTP status code | Payload |
    | :--- | :--- | :--- | :--- |
    | number | string | 404 |  |
servers:
  - url: https://api.reelevant.com/v2/
    description: production
security: []
paths:
  /contents/resources/derive:
    post:
      tags:
        - ContentResource
      description: >-
        Derive an image with a named recipe and answer with the asset

        it is stored under, so a caller that cannot run the recipe itself (a pod

        without the matte model) can have the deployment holding it do the work
        and

        then draw the result from the shared store.


        Internal only: it derives an arbitrary url on demand, and the identity
        it

        derives into is the `x-rlvt-company-id` of the internal request, so it
        is

        refused without the internal secret rather than left to a user token.
      operationId: derive-content-resource
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                recipe:
                  type: string
                  description: Name of the recipe to apply
                url:
                  type: string
                  description: Source image url
              required:
                - recipe
                - url
              additionalProperties: false
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                allOf:
                  - type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - success
                    required:
                      - status
                    additionalProperties: false
                  - $ref: >-
                      #/components/schemas/InternalResponse_identifier_string_version_string_contentType_string_generated_Union_false_true
      security:
        - password_auth: []
components:
  schemas:
    InternalResponse_identifier_string_version_string_contentType_string_generated_Union_false_true:
      type: object
      properties:
        program:
          type: string
        version:
          type: string
        datetime:
          type: string
        status:
          type: string
        code:
          type: number
        message:
          type: string
        data:
          type: object
          properties:
            identifier:
              type: string
            version:
              type: string
            contentType:
              type: string
            generated:
              type: boolean
          required:
            - identifier
            - version
            - contentType
            - generated
          additionalProperties: false
      required:
        - program
        - version
        - datetime
        - status
        - message
        - data
      additionalProperties: false
  securitySchemes:
    password_auth:
      type: oauth2
      flows:
        password:
          tokenUrl: https://api.reelevant.com/v2/auth/token
          refreshUrl: https://api.reelevant.com/v2/auth/token
          scopes: {}

````