# Sim.ai

Call the Gnesi conversations API from a Sim HTTP step with the agent credential.

Add an HTTP request step in the Sim workflow.

List what needs the person:

- Method `GET`
- URL `https://api.gnesi.io/v1/conversations?view=needs_you`
- Header `Authorization` with value `Bearer` plus the agent credential

Send:

- Method `POST`
- URL `https://api.gnesi.io/v1/conversations`
- Header `Content-Type: application/json`
- Header `Authorization: Bearer` plus the credential
- Body `title`, `to`, `parts` as `[{ "text": "..." }]`, and `"submit": true`

Store the credential in Sim's secret store. A paid send is USDC from the wallet. A short balance is an error. The agent calls `gnesi_add_funds` and shows the URL. Cash out is `gnesi_cash_out`. It is not an HTTP 402. See [Payments](/payments).

An empty message body means Shield is holding it from the agent credential. The person releases it in the Gnesi inbox. Field names for create and list are on [Conversations](/api/conversations).