> ## Documentation Index
> Fetch the complete documentation index at: https://autorender.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Source details
> Full record for one source by its id.
**Key type:** requires a private key. A public key returns `403` here, because it may only
upload — see [key types and scope](/docs/api-reference/introduction#key-types-and-scope). Call
this from your server, never from browser code.
```bash cURL theme={null}
curl --request GET \
--url 'https://upload.autorender.io/api/v1/sources/974628c2-9b55-4ce4-adf1-9b63edff6baa' \
--header 'Authorization: Bearer YOUR_API_KEY'
```
```json 200 theme={null}
{
"success": true,
"data": {
"id": "974628c2-9b55-4ce4-adf1-9b63edff6baa",
"name": "my_image_source",
"type": "image_source",
"configuration": {
"base_url": "https://cdn.example.com",
"forward_header": true
},
"is_active": true,
"created_at": "2026-03-27T14:58:53.795Z",
"updated_at": "2026-03-27T14:58:53.795Z"
}
}
```
```json 404 theme={null}
{
"error": "Source not found"
}
```
## Overview
Returns the full record for a single source, looked up by **`sourceId`**. The response is wrapped as `{ "success": true, "data": { ... } }`. Returns `404` if the id doesn't exist or belongs to a different workspace.
## Path parameters
| Parameter | Description |
| ---------- | -------------------------------------------------------------------------------------------------------------------------- |
| `sourceId` | Source id (UUID), returned by [list sources](/docs/api-reference/list-sources) or [create source](/docs/api-reference/create-source) |
## `data` object
`id`, `name`, `type`, `configuration` (secrets masked), `is_active`, `created_at`, `updated_at`
## Next steps
Change this source's name or configuration.
Permanently remove this source from your workspace.
## OpenAPI
````yaml api-reference/openapi.json GET /api/v1/sources/{sourceId}
openapi: 3.0.0
info:
title: AutoRender Public API
description: >-
REST API for uploading, managing, and serving media assets. All endpoints
require an API key via the x-api-key header or Authorization: Bearer .
version: 1.0.0
contact:
name: AutoRender Support
email: support@autorender.io
servers:
- url: https://app-api.autorender.io
description: Production server
security:
- apiKey: []
tags:
- name: Uploads
description: Upload endpoints (API key required)
- name: Files
description: File management endpoints (API key required)
- name: Folders
description: Folder management endpoints (API key required)
- name: Sources
description: Source management endpoints (API key required)
paths:
/api/v1/sources/{sourceId}:
get:
tags:
- Sources
summary: Get source details
operationId: getSource
parameters:
- schema:
type: string
format: uuid
pattern: >-
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
in: path
name: sourceId
required: true
description: Source ID
responses:
'200':
description: Source details
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
enum:
- true
data:
type: object
properties:
id:
type: string
format: uuid
pattern: >-
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
name:
type: string
type:
type: string
enum:
- s3
- azure
- google_cloud
- image_source
configuration:
type: object
properties: {}
additionalProperties:
x-stainless-any: true
is_active:
type: boolean
created_at:
type: string
format: date-time
pattern: >-
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
updated_at:
nullable: true
type: string
format: date-time
pattern: >-
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
required:
- id
- name
- type
- configuration
- is_active
- created_at
- updated_at
additionalProperties: false
required:
- success
- data
additionalProperties: false
description: Source details
'401':
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
required:
- error
- message
additionalProperties: false
description: Unauthorized
'403':
description: Private API key required
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
required:
- error
- message
additionalProperties: false
description: Private API key required
'404':
description: Source not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
additionalProperties: false
description: Source not found
'429':
description: Rate limit exceeded
content:
application/json:
schema:
type: object
properties:
error:
type: string
message:
type: string
retryAfterSeconds:
type: number
required:
- error
- message
additionalProperties: false
description: Rate limit exceeded
security:
- apiKey: []
components:
securitySchemes:
apiKey:
type: apiKey
name: x-api-key
in: header
description: >-
API key for public endpoints. Can also be provided via Authorization:
Bearer
````