# Developer Documentation

## Docs

- [List source specs](https://developer.portable.io/api-reference/source-specs/list-source-specs.md): List all source specs
- [Get source spec](https://developer.portable.io/api-reference/source-specs/get-source-spec.md): Get a source spec by name
- [List sources](https://developer.portable.io/api-reference/sources/list-sources.md): List all the sources. A source is an instantiation of a source spec.
- [Create source](https://developer.portable.io/api-reference/sources/create-source.md): Create a new source
- [Get source](https://developer.portable.io/api-reference/sources/get-source.md): Get a source by ID
- [Delete source](https://developer.portable.io/api-reference/sources/delete-source.md): Delete an existing source
- [Update source](https://developer.portable.io/api-reference/sources/update-source.md): Update an existing source
- [Verify if a source is properly configured](https://developer.portable.io/api-reference/sources/verify-if-a-source-is-properly-configured.md): Use this endpoint to validate the properties for the specified source. If any required property is missing, the response will include a relevant error message. If all required properties are present, it attempts to establish a connection with the source's API servers and returns a status message ind…
- [Discover dynamic resolvers for a source](https://developer.portable.io/api-reference/sources/discover-dynamic-resolvers-for-a-source.md): Starts an asynchronous process to discover dynamic resolvers for the specified source. This process runs in the background. To check the status of the discovery process and retrieve the discovered resources, poll the `GET /v2/sources/{id}/resolvers` endpoint.
- [Get discovered resolvers for a source](https://developer.portable.io/api-reference/sources/get-discovered-resolvers-for-a-source.md): Returns the list of discovered resolvers for the specified source, including both static (spec-defined) and dynamic resolvers found during the last discovery or extraction process.
- [List destination specs](https://developer.portable.io/api-reference/destination-specs/list-destination-specs.md): List all supported destination specs
- [Get destination spec](https://developer.portable.io/api-reference/destination-specs/get-destination-spec.md): Get a destination spec by name
- [List destinations](https://developer.portable.io/api-reference/destinations/list-destinations.md): List all the destinations for the given user. A destination is where the data from a source gets loaded into.
- [Create a destination](https://developer.portable.io/api-reference/destinations/create-a-destination.md): Create a new destination
- [Get destination](https://developer.portable.io/api-reference/destinations/get-destination.md): Get a destination by ID
- [Delete destination](https://developer.portable.io/api-reference/destinations/delete-destination.md): Delete an existing destination
- [Update destination](https://developer.portable.io/api-reference/destinations/update-destination.md): Update an existing destination
- [Verify if a destination is properly configured](https://developer.portable.io/api-reference/destinations/verify-if-a-destination-is-properly-configured.md): Use this endpoint to validate the properties for the specified destination. If any required property is missing, the response will include a relevant error message. If all required properties are present, it attempts to establish a connection with the destination and returns a status message indicat…
- [List flows](https://developer.portable.io/api-reference/flows/list-flows.md): List all the existing flows. A flow is a combination of a source and an environment.
- [Create flow](https://developer.portable.io/api-reference/flows/create-flow.md): Create a new flow
- [Get flow](https://developer.portable.io/api-reference/flows/get-flow.md): Get a flow by ID
- [Delete flow](https://developer.portable.io/api-reference/flows/delete-flow.md): Delete an existing flow
- [Update flow](https://developer.portable.io/api-reference/flows/update-flow.md): Update an existing flow
- [Get flow status](https://developer.portable.io/api-reference/flows/get-flow-status.md): Get a flow's status by flow ID. Use this endpoint to check whether a flow is running or not, or get details about the flow's last run. The response includes the flow's lifecycle status, disposition, and the status of the resources involved in the
- [Get flow run attempts](https://developer.portable.io/api-reference/flows/get-flow-run-attempts.md): Get a flow's run attempts by flow ID
- [Run a flow](https://developer.portable.io/api-reference/flows/run-a-flow.md): Initiates a run of a flow by flow ID. The flow will be run asynchronously. Use `/v2/flows/{id}/status` to check the status of this run.
- [Cancel a running flow](https://developer.portable.io/api-reference/flows/cancel-a-running-flow.md): Cancels an ongoing run of a flow by flow ID. If the flow is not running, this operation has no effect. You can use `/v2/flows/{id}/status` to check the status of this run.
- [List workflows](https://developer.portable.io/api-reference/workflows/list-workflows.md): List all workflows
- [Create workflow](https://developer.portable.io/api-reference/workflows/create-workflow.md): Create a new workflow
- [Get workflow](https://developer.portable.io/api-reference/workflows/get-workflow.md): Get a workflow by ID
- [Delete workflow](https://developer.portable.io/api-reference/workflows/delete-workflow.md): Delete a workflow
- [Update workflow](https://developer.portable.io/api-reference/workflows/update-workflow.md): Update a workflow
- [Get workflow status](https://developer.portable.io/api-reference/workflows/get-workflow-status.md): Get a workflow's status by workflow ID. Use this endpoint to check whether a workflow is running or not, or get details about the workflow's last run.
- [Run workflow](https://developer.portable.io/api-reference/workflows/run-workflow.md): Trigger a workflow run
- [Cancel workflow run](https://developer.portable.io/api-reference/workflows/cancel-workflow-run.md): Cancel a workflow run
- [List workflow runs](https://developer.portable.io/api-reference/workflows/list-workflow-runs.md): List runs for a workflow
- [Create configuration card link for a source](https://developer.portable.io/api-reference/configuration-cards/create-configuration-card-link-for-a-source.md): Create a new configuration card link for a given source
- [List webhook triggers](https://developer.portable.io/api-reference/webhooks/list-webhook-triggers.md): List all webhook triggers for a workflow
- [Create webhook trigger](https://developer.portable.io/api-reference/webhooks/create-webhook-trigger.md): Create a new webhook trigger for a workflow
- [Get webhook trigger](https://developer.portable.io/api-reference/webhooks/get-webhook-trigger.md): Get a webhook trigger by ID
- [Delete webhook trigger](https://developer.portable.io/api-reference/webhooks/delete-webhook-trigger.md): Delete a webhook trigger
- [Update webhook trigger](https://developer.portable.io/api-reference/webhooks/update-webhook-trigger.md): Update a webhook trigger (currently only status can be updated)

## OpenAPI Specs

- [api-spec-v2](https://developer.portable.io/api-spec-v2.yaml)
- [openapi](https://developer.portable.io/api-reference/openapi.json)