Stac Connect
POST
/services/stac/connect
const url = 'https://example.com/api/services/stac/connect';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"url":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/services/stac/connect \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "url": "example" }'Connect to a STAC API and validate the endpoint.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ” Media type application/json
StacConnectRequest
object
url
required
Url
STAC API root URL to connect to.
string
Example generated
{ "url": "example"}Responses
Section titled “ Responses ”Successful Response
Media type application/json
StacConnectResponse
object
url
required
Url
Normalized STAC API URL.
string
catalog_id
required
Catalog Id
Catalog identifier from the landing page.
string
title
required
Title
Catalog title.
string
description
required
Description
Catalog description.
string
stac_version
required
Stac Version
STAC specification version.
string
Example generated
{ "url": "example", "catalog_id": "example", "title": "example", "description": "example", "stac_version": "example"}Bad request — invalid payload
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Unauthorized — missing or invalid credentials
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Forbidden — caller lacks write access
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Not found
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Conflict — resource state prevents the operation
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Validation error
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Internal server error
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}