> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentlinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# linktrail connect

> Verify and save a cloud connection.

```bash theme={null}
linktrail connect --workspace ws_example --project-id prj_example
```

## Behavior and output

Requires an existing workspace/project and API credential. Verifies projects:read, watches:read, watches:write, events:read and exports:create scopes. Saves non-secret origin/workspace/project metadata; removes a saved cloud.token. Refuses identity changes that would mix ledger histories.

## Arguments

\--workspace ID; --project-id ID; --origin HTTPS\_ORIGIN defaults to saved origin or [https://app.agentlinkops.com](https://app.agentlinkops.com); --selection FILE contains ledger IDs or an object with entries\[].local\_id.

## Exit status

0 on success; 2 on usage, configuration, input or request failure.

Read [configuration and file ownership](/reference/local/configuration) before automating this command. Read [local file contracts](/reference/local/artifacts) for artifact fields. Browse the [local command index](/reference/local/index) for related commands.

<Note>Reference follows the current development CLI and HTTP contracts. Hosted availability depends on the selected environment. See [capability status](/capability-status).</Note>