← Back to library

Atlas documentation

Use connected tools

Understand the catalogue, connection state and action results.

Read the catalogue accurately

The catalogue counts integration entries, including planned entries. It is not a count of tools enabled in your workspace. An available catalogue entry still needs a working, authorized connection.

Open a room

Select the integration in Atlas, connect the appropriate account and inspect the available tools. Start with a narrow read. Review the returned records before requesting a mutation.

Handle failures

A provider error is a failed operation, even if the transport connected successfully. Check credentials, scopes, rate limits and service availability. Retry only when it is safe to avoid duplicate changes.

Keep evidence

Use the result and receipt to link the operation back to its source. Do not substitute a sample response or a generated status for an actual provider result.

Read the guides