> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/acoes/workflow-concepts/run-once/api.md).

# Executar via API

Chame os seus Workflows AirOps através de endpoints

Depois de publicar o seu fluxo de trabalho, pode chamá-lo através dos nossos endpoints da API, utilizando os parâmetros de entrada necessários para receber uma resposta. Para uma visão geral ampla das capacidades da nossa API, consulte a nossa [Referência da API](broken://spaces/rT8WZaGa5JcV0M5osTWg) para especificações técnicas detalhadas.

## Autenticação

Todos os endpoints requerem autenticação através de um token Bearer. Para autenticar, inclua um cabeçalho Authorization no seu pedido com o valor Bearer YOUR\_API\_KEY. Pode encontrar a sua chave de API na sua [Definições do espaço de trabalho](https://docs.airops.com/docs/pt/o-seu-espaco-de-trabalho/workspaces.md#workspace-settings):

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-835de7e23f1edeada63f208a8317424945a03259%2Frun-api-01-api-key.png?alt=media" alt="Workspace settings with the masked API key and the Regenerate button"><figcaption><p>Encontre a sua chave de API em Definições > Workspace.</p></figcaption></figure>

## Encontrar o seu ID do fluxo de trabalho

Além do seu API Token, também precisará do seu ID do fluxo de trabalho para garantir que as suas chamadas à API estão a chegar ao endpoint correto. O ID do fluxo de trabalho é o número encontrado no URL da aplicação. Por exemplo, no URL:

```
https://app.airops.com/{your_workspace}/apps/123
```

O ID do fluxo de trabalho é:

```
123
```

Além disso, pode também consultar o separador "Rest API" para o fluxo de trabalho mostrado mais abaixo.

## Endpoints

Para encontrar os parâmetros adicionais e os endpoints disponíveis para o seu fluxo de trabalho, pode navegar até ao separador "REST API", na secção "Integrate" do seu fluxo de trabalho:

Pronto para fazer o seu primeiro pedido? Consulte [a documentação de referência da API](https://developers.airops.com) para mais detalhes!

{% @arcade/embed url="<https://app.arcade.software/share/XLLOnL04P09gRC3dAwLv>" flowId="XLLOnL04P09gRC3dAwLv" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/acoes/workflow-concepts/run-once/api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
