---
title: "Starts the process of retrieving dynamic metadata for the specified component."
method: POST
path: "/components/{component_id}/versions/{git_revision}/dynamic-metadata"
tags: ["scheduled executions"]
---

# Starts the process of retrieving dynamic metadata for the specified component.

`POST /components/{component_id}/versions/{git_revision}/dynamic-metadata`

You need to have `workspaces.flow.edit` permission to access this resource.
The retrieval of metamodel is an asynchronous process because it is accomplished by sending a request to an external API.

## Path parameters

- `component_id` string, required
- `git_revision` string, required

## Request body

- object
  - `data` object, required
    - `type` 'dynamic-metadata', required — A value must be `dynamic-metadata`.
    - `attributes` object, required
      - `module` string, required — Name of the component’s module as defined in `component.json`.
      - `fields` object, required — Contains values for component’s fields.
      - `log_level` 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal' — Log level of component running in this step
    - `relationships` object, required
      - `workspace` object, required
        - `data` object, required
          - `id` string, required — Workspace identifier.
          - `type` 'workspace', required — Value must be `workspace`
      - `credential` object
        - `data` object, required
          - `id` string, required — Credential identifier. If credentials are specified in the component’s descriptor, create a credential first and use its id.
          - `type` 'credential', required — Value must be `credential`
      - `agent` object
        - `data` object, required
          - `id` string, required — Agent identifier.
          - `type` 'agent', required — Value must be `agent`

## Response `202`

Accepted

- object
  - `data` object, required
    - `id` string, required
    - `type` 'execution-result', required
    - `links` object, required
      - `self` string, required
    - `attributes` object, required
      - `result` object, required
      - `status` string, required
  - `meta` object, required

## Other responses

- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2.md) · [All operations](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/elastic-io-rest-api-documentation-v2/revisions/411f9f98c01e/schema)
