> ## Documentation Index > Fetch the complete documentation index at: https://docs.sixtyfour.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create or replace a connected source > Create the connection ``name``, or replace its settings and, when ``secret`` is given, its secret. Only ``base_url`` and ``secret`` are required. Runs already going read the change at their next call. ## OpenAPI ````yaml /openapi.json put /connections/{name} openapi: 3.1.0 info: title: Sixtyfour API description: >- Intelligence API for people and companies: research agents that investigate, resolve identities, map relationships and surface risk signals. contact: name: Sixtyfour url: https://sixtyfour.ai/ email: support@sixtyfour.ai license: name: Proprietary version: 1.0.0 servers: - url: https://api.sixtyfour.ai description: Production security: - ApiKeyAuth: [] - BearerAuth: [] tags: - name: Enrichment description: Find and enrich emails, phones, and LinkedIn for people and companies. - name: Search description: Run deep and filter searches over Sixtyfour's data. - name: Workflow description: Create, run, and manage enrichment workflows. - name: Workflow Schedules description: Create and manage recurring schedules for workflows. - name: Account description: Manage and inspect your account and credit balance. - name: Feedback description: >- Tell us a result was wrong, missing or outdated, and report problems with the API, the docs or a tool. - name: Intelligence description: Verify identity attributes such as age using high-tier OSINT research. - name: Atlas description: >- Start, continue and read Atlas investigations: attribution graph, workspace files, reports and exports. paths: /connections/{name}: put: tags: - Connections summary: Create or replace a connected source description: >- Create the connection ``name``, or replace its settings and, when ``secret`` is given, its secret. Only ``base_url`` and ``secret`` are required. Runs already going read the change at their next call. operationId: put_connection_connections__name__put parameters: - name: name in: path required: true schema: type: string title: Name requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PutConnectionRequest' example: base_url: https://api.crm.example.com/v2 secret: YOUR_READ_ONLY_KEY description: 'Our CRM: accounts, contacts and deal notes' allowed_requests: - POST /search responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/SavedConnection' example: id: 6f1c2a9e-4b7d-4e3a-9c5f-2d8e1b0a7c43 name: crm description: 'Our CRM: accounts, contacts and deal notes' base_url: https://api.crm.example.com/v2 sign_in: type: bearer name: null allowed_requests: - POST /search secret_last4: _KEY created_at: '2026-11-05T03:40:00Z' updated_at: '2026-11-05T03:40:00Z' created: true '400': description: Invalid request. content: application/json: schema: properties: detail: type: string feedback: type: string description: How to report a problem with this response. code: type: string description: Stable error code, for programs. correlation_id: type: string description: >- This request's ID, also in `X-Correlation-ID`. Quote it to support. type: object example: detail: Invalid request body code: bad_request correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21 feedback: >- Problem with this response? POST /feedback with message and operation; include correlation_id in your message. '401': description: Missing or invalid API key. content: application/json: schema: properties: detail: type: string feedback: type: string description: How to report a problem with this response. code: type: string description: Stable error code, for programs. correlation_id: type: string description: >- This request's ID, also in `X-Correlation-ID`. Quote it to support. type: object example: detail: Invalid API key code: unauthenticated correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21 feedback: >- Problem with this response? POST /feedback with message and operation; include correlation_id in your message. '403': description: Organization access is locked. content: application/json: schema: properties: detail: type: string feedback: type: string description: How to report a problem with this response. code: type: string description: Stable error code, for programs. correlation_id: type: string description: >- This request's ID, also in `X-Correlation-ID`. Quote it to support. type: object example: detail: >- This organization no longer has access to Sixtyfour. Contact your representative at Sixtyfour. code: forbidden correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21 feedback: >- Problem with this response? POST /feedback with message and operation; include correlation_id in your message. '422': description: Request body failed validation. content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: >- More than 60 requests per minute per API key, signed-in person or OAuth client. Retry after the delay in Retry-After. content: application/json: schema: properties: detail: type: string feedback: type: string description: How to report a problem with this response. code: type: string description: Stable error code, for programs. correlation_id: type: string description: >- This request's ID, also in `X-Correlation-ID`. Quote it to support. type: object example: detail: >- Rate limit exceeded: 60 requests per minute. Retry after 1 second. code: rate_limited correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21 feedback: >- Problem with this response? POST /feedback with message and operation; include correlation_id in your message. headers: Retry-After: description: Seconds before retrying schema: type: string example: '1' x-rate-limit: requests: 60 period_seconds: 60 scope: API key, signed-in person or OAuth client '500': description: Unexpected server error. Retry with backoff. content: application/json: schema: properties: detail: type: string feedback: type: string description: How to report a problem with this response. code: type: string description: Stable error code, for programs. correlation_id: type: string description: >- This request's ID, also in `X-Correlation-ID`. Quote it to support. type: object example: detail: Internal server error code: internal_error correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21 feedback: >- Problem with this response? POST /feedback with message and operation; include correlation_id in your message. '503': description: >- Temporarily unavailable. Nothing was charged; retry after the `Retry-After` header. content: application/json: schema: properties: detail: type: string feedback: type: string description: How to report a problem with this response. code: type: string description: Stable error code, for programs. correlation_id: type: string description: >- This request's ID, also in `X-Correlation-ID`. Quote it to support. type: object example: detail: Could not verify the API key right now. Retry shortly. code: unavailable correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21 feedback: >- Problem with this response? POST /feedback with message and operation; include correlation_id in your message. components: schemas: PutConnectionRequest: properties: base_url: anyOf: - type: string maxLength: 2048 - type: 'null' title: Base Url description: Required. An https URL, such as https://api.example.com/v2 secret: title: Secret description: >- The API key, token or password, best a read-only one. Required to create; leave it out to keep the saved one description: anyOf: - type: string maxLength: 2000 - type: 'null' title: Description description: 'One line: what it''s for' sign_in: anyOf: - $ref: '#/components/schemas/SignIn' - type: 'null' description: How the secret is sent; bearer when left out username: title: Username description: For a basic sign-in, sent with the secret as its password allowed_requests: anyOf: - items: type: string maxLength: 2048 type: array - type: 'null' title: Allowed Requests description: >- A method and a path under the base URL each, such as 'POST /search'; left out, calls may GET and HEAD anywhere under it team_id: anyOf: - type: string maxLength: 200 - type: 'null' title: Team Id description: >- The team the change was made for; refused when the caller's active team is another create_only: type: boolean title: Create Only description: >- Only create: refused when the team already has a connection by this name default: false type: object title: PutConnectionRequest SavedConnection: properties: id: type: string title: Id name: type: string title: Name description: How a run and its agents name the connection description: type: string title: Description description: What it's for, as the agents read it; empty for none base_url: type: string title: Base Url description: 'Where the API lives: calls go to this https URL and paths under it' sign_in: $ref: '#/components/schemas/SignIn' allowed_requests: anyOf: - items: type: string type: array - type: 'null' title: Allowed Requests description: >- The requests a call may make, a method and a path under the base URL each; null for read-only (GET and HEAD anywhere under it) secret_last4: type: string title: Secret Last4 description: >- The last four characters of the secret; the secret itself is never returned created_at: anyOf: - type: string format: date-time - type: 'null' title: Created At updated_at: anyOf: - type: string format: date-time - type: 'null' title: Updated At created: type: boolean title: Created description: >- True when this write created the connection, false when it replaced one type: object required: - id - name - description - base_url - sign_in - allowed_requests - secret_last4 - created title: SavedConnection HTTPValidationError: title: HTTPValidationError type: object properties: detail: type: array items: $ref: '#/components/schemas/ValidationError' feedback: type: string description: How to report a problem with this response. code: type: string description: Stable error code, for programs. correlation_id: type: string description: This request's ID, also in `X-Correlation-ID`. Quote it to support. example: detail: - loc: - body - target_company - domain msg: Field required type: missing input: null ctx: {} code: invalid_request correlation_id: enrich_3f8b2c1e-9d4a-4c1b-8e2f-6a7b5c4d3e21 feedback: >- Problem with this response? POST /feedback with message and operation; include correlation_id in your message. SignIn: properties: type: type: string maxLength: 200 title: Type description: >- How the secret is sent: bearer (Authorization: Bearer), header, query, or basic (HTTP Basic) default: bearer name: anyOf: - type: string maxLength: 200 - type: 'null' title: Name description: >- The header or query parameter the secret goes in, for header and query type: object title: SignIn ValidationError: title: ValidationError type: object required: - loc - msg - type properties: loc: type: array items: oneOf: - type: string - type: integer description: Path to the field that failed validation. example: - body - target_company - domain msg: type: string description: Human-readable error message. example: Field required type: type: string description: Error code (e.g. 'missing', 'value_error'). example: missing input: description: The offending input value (any type, may be null). nullable: true example: null ctx: type: object description: Optional error context. additionalProperties: true example: {} securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: Your Sixtyfour API key. BearerAuth: type: http scheme: bearer description: >- An OAuth access token from `POST /oauth/token`, sent as `Authorization: Bearer `. An API key sent as a bearer token is refused with 401. When both headers are sent, the bearer token is used. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.