---
title: "Add metaproperty options"
url: "https://earlyaccess.developers.bynder.com/apis/asset-management-api-1/versions/b623ec0a-a559-4667-a0ee-28fa2b9cd7ce/paths/api-media-options/post"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/asset-management-api-1/versions/b623ec0a-a559-4667-a0ee-28fa2b9cd7ce.md

# Add metaproperty options

`POST` `/api/media/options`

These calls allow you to change the metaproperty options attached to an asset. **Note that this is an append operation; the options you add here will be appended to the existing option on the asset, it does not overwrite them.**

## Request body (required)

Content types: `application/json`

## Responses

- `201` - Created
- `403` - Access denied
- `404` - Not Found

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Asset Management API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/media/options:
    post:
      description: >-
        These calls allow you to change the metaproperty options attached to an
        asset.


        **Note that this is an append operation; the options you add here will
        be appended to the existing option on the asset, it does not overwrite
        them.**
      requestBody:
        content:
          application/json:
            examples:
              example1:
                value:
                  asset_id: 00000000-0000-0000-0000000000000000
                  metaproperty_id: 00000000-0000-0000-0000000000000000
                  metaproperty_option_ids:
                    - 00000000-0000-0000-0000000000000000
                    - 00000000-0000-0000-0000000000000001
            schema:
              properties:
                asset_id:
                  example: 00000000-0000-0000-0000000000000000
                  type: string
                metaproperty_id:
                  example: 00000000-0000-0000-0000000000000000
                  type: string
                metaproperty_option_ids:
                  items:
                    example: 00000000-0000-0000-0000000000000000
                    type: string
                  type: array
              type: object
        required: true
      responses:
        "201":
          content:
            application/json:
              schema:
                properties:
                  message:
                    example: Created
                    type: string
                  statuscode:
                    example: 201
                    type: integer
                type: object
          description: Created
        "403":
          content:
            application/json:
              schema:
                properties:
                  message:
                    example: Access denied
                    type: string
                  statuscode:
                    example: 403
                    type: integer
                type: object
          description: Access denied
        "404":
          content:
            application/json:
              schema:
                properties:
                  message:
                    example: Not Found
                    type: string
                  statuscode:
                    example: 404
                    type: integer
                type: object
          description: Not Found
      security:
        - permanentToken:
            - MEDIAEDIT
        - OAuth2:
            - MEDIAEDIT
      summary: Add metaproperty options
      tags:
        - Media options
security:
  - permanentToken:
      - MEDIAEDIT
  - OAuth2:
      - MEDIAEDIT
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            ARCHIVEDOWNLOAD: ""
            ARCHIVEMEDIA: ""
            EMARGOMEDIA: ""
            KEYVISUALDOWNLOAD: ""
            MARKPUBLIC: ""
            MEDIAEDIT: ""
            MEDIAREMOVE: ""
            STATISTICS: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            ARCHIVEDOWNLOAD: ""
            ARCHIVEMEDIA: ""
            EMARGOMEDIA: ""
            KEYVISUALDOWNLOAD: ""
            MARKPUBLIC: ""
            MEDIAEDIT: ""
            MEDIAREMOVE: ""
            STATISTICS: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
```