> 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 de API usando os parâmetros de entrada necessários para receber uma resposta. Para uma visão geral das capacidades da nossa API, consulte o nosso [Referência da API](broken://spaces/rT8WZaGa5JcV0M5osTWg) para especificações técnicas detalhadas.
## Autenticação
Todos os endpoints requerem autenticação usando 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 no seu [Definições da Área de trabalho](/docs/pt/o-seu-espaco-de-trabalho/workspaces.md#workspace-settings):
## Como Encontrar o ID do Seu Fluxo de Trabalho
Além do seu Token de API, também precisará do ID do seu Fluxo de Trabalho para garantir que as suas chamadas de 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 consultar o separador "API REST" para o Fluxo de Trabalho mostrado mais abaixo.
## Endpoints
Para encontrar os parâmetros e endpoints adicionais disponíveis para o seu Fluxo de Trabalho, pode navegar para o separador "API REST", por baixo da secção "Integrar" do seu Fluxo de Trabalho:
Pronto para fazer o seu primeiro pedido? Consulte [documentação de referência da API](https://developers.airops.com) para mais detalhes!
{% @arcade/embed url="" 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=&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.
