API Reference

Auto-generated

Map

API reference for map endpoints.

Auto-generated

This page was generated from the OpenAPI spec. Runmake generate-docs to refresh after spec changes.

POST /api/v1/map/schedules

POST

/api/v1/map/schedules

Create Map Schedule

Parameters

Name	Type	Required	Description
name	`string`	Required	Name
cron	`string`	Required	Cron expression (5 fields), e.g. '0 6 * * 1'
timezone	`string`	Optional	TimezoneDefault: `UTC`
map_config	`object`	Required	Frozen map configuration executed on each scheduled run. Mirrors the essential fields of MapRequest but stored as a JSON blob so the schedule is self-contained (no user input at execution time).
max_runs	`integer`	Optional	max_runs
enabled	`boolean`	Optional	EnabledDefault: `True`

Request Example

Bash

curl -X POST https://api.alterlab.io/api/v1/map/schedules \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "example_name",
    "cron": "example_cron",
    "timezone": "example_timezone",
    "map_config": "..."
  }'

Response Example

JSON

{
  "status": "ok"
}

GET /api/v1/map/schedules

GET

/api/v1/map/schedules

List Map Schedules

Parameters

Name	Type	Required	Description
limit	`integer`	Optional	limitDefault: `20`
offset	`integer`	Optional	offsetDefault: `0`
active_only	`boolean`	Optional	active_onlyDefault: `False`

Request Example

Bash

curl -X GET https://api.alterlab.io/api/v1/map/schedules \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "schedules": [],
  "total": 0
}

GET /api/v1/map/schedules/{schedule_id}

GET

/api/v1/map/schedules/{schedule_id}

Get Map Schedule

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id

Request Example

Bash

curl -X GET https://api.alterlab.io/api/v1/map/schedules/<schedule_id> \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "id": "example",
  "name": "example",
  "cron": "example",
  "timezone": "example",
  "map_config": {},
  "max_runs": "example"
}

PATCH /api/v1/map/schedules/{schedule_id}

PATCH

/api/v1/map/schedules/{schedule_id}

Update Map Schedule

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id
name	`string`	Optional	name
cron	`string`	Optional	cron
timezone	`string`	Optional	timezone
map_config	`object`	Optional	Frozen map configuration executed on each scheduled run. Mirrors the essential fields of MapRequest but stored as a JSON blob so the schedule is self-contained (no user input at execution time).
max_runs	`integer`	Optional	max_runs
enabled	`boolean`	Optional	enabled

Request Example

Bash

curl -X PATCH https://api.alterlab.io/api/v1/map/schedules/<schedule_id> \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "id": "example",
  "name": "example",
  "cron": "example",
  "timezone": "example",
  "map_config": {},
  "max_runs": "example"
}

DELETE /api/v1/map/schedules/{schedule_id}

DELETE

/api/v1/map/schedules/{schedule_id}

Delete Map Schedule

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id

Request Example

Bash

curl -X DELETE https://api.alterlab.io/api/v1/map/schedules/<schedule_id> \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "status": "ok"
}

POST /api/v1/map/schedules/{schedule_id}/pause

POST

/api/v1/map/schedules/{schedule_id}/pause

Pause Map Schedule

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id

Request Example

Bash

curl -X POST https://api.alterlab.io/api/v1/map/schedules/<schedule_id>/pause \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "id": "example",
  "name": "example",
  "cron": "example",
  "timezone": "example",
  "map_config": {},
  "max_runs": "example"
}

POST /api/v1/map/schedules/{schedule_id}/resume

POST

/api/v1/map/schedules/{schedule_id}/resume

Resume Map Schedule

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id

Request Example

Bash

curl -X POST https://api.alterlab.io/api/v1/map/schedules/<schedule_id>/resume \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "id": "example",
  "name": "example",
  "cron": "example",
  "timezone": "example",
  "map_config": {},
  "max_runs": "example"
}

POST /api/v1/map/schedules/{schedule_id}/run

POST

/api/v1/map/schedules/{schedule_id}/run

Run Map Schedule Now

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id

Request Example

Bash

curl -X POST https://api.alterlab.io/api/v1/map/schedules/<schedule_id>/run \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "id": "example",
  "schedule_id": "example",
  "status": "example",
  "map_id": "example",
  "urls_discovered": 0,
  "credits_used": 0
}

GET /api/v1/map/schedules/{schedule_id}/runs

GET

/api/v1/map/schedules/{schedule_id}/runs

List Map Schedule Runs

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id
limit	`integer`	Optional	limitDefault: `20`
offset	`integer`	Optional	offsetDefault: `0`

Request Example

Bash

curl -X GET https://api.alterlab.io/api/v1/map/schedules/<schedule_id>/runs \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "runs": [],
  "total": 0
}

Last updated: March 2026

API Reference

Auto-generated

Map

API reference for map endpoints.

Auto-generated

This page was generated from the OpenAPI spec. Runmake generate-docs to refresh after spec changes.

POST /api/v1/map/schedules

POST

/api/v1/map/schedules

Create Map Schedule

Parameters

Name	Type	Required	Description
name	`string`	Required	Name
cron	`string`	Required	Cron expression (5 fields), e.g. '0 6 * * 1'
timezone	`string`	Optional	TimezoneDefault: `UTC`
map_config	`object`	Required	Frozen map configuration executed on each scheduled run. Mirrors the essential fields of MapRequest but stored as a JSON blob so the schedule is self-contained (no user input at execution time).
max_runs	`integer`	Optional	max_runs
enabled	`boolean`	Optional	EnabledDefault: `True`

Request Example

Bash

curl -X POST https://api.alterlab.io/api/v1/map/schedules \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "example_name",
    "cron": "example_cron",
    "timezone": "example_timezone",
    "map_config": "..."
  }'

Response Example

JSON

{
  "status": "ok"
}

GET /api/v1/map/schedules

GET

/api/v1/map/schedules

List Map Schedules

Parameters

Name	Type	Required	Description
limit	`integer`	Optional	limitDefault: `20`
offset	`integer`	Optional	offsetDefault: `0`
active_only	`boolean`	Optional	active_onlyDefault: `False`

Request Example

Bash

curl -X GET https://api.alterlab.io/api/v1/map/schedules \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "schedules": [],
  "total": 0
}

GET /api/v1/map/schedules/{schedule_id}

GET

/api/v1/map/schedules/{schedule_id}

Get Map Schedule

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id

Request Example

Bash

curl -X GET https://api.alterlab.io/api/v1/map/schedules/<schedule_id> \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "id": "example",
  "name": "example",
  "cron": "example",
  "timezone": "example",
  "map_config": {},
  "max_runs": "example"
}

PATCH /api/v1/map/schedules/{schedule_id}

PATCH

/api/v1/map/schedules/{schedule_id}

Update Map Schedule

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id
name	`string`	Optional	name
cron	`string`	Optional	cron
timezone	`string`	Optional	timezone
map_config	`object`	Optional	Frozen map configuration executed on each scheduled run. Mirrors the essential fields of MapRequest but stored as a JSON blob so the schedule is self-contained (no user input at execution time).
max_runs	`integer`	Optional	max_runs
enabled	`boolean`	Optional	enabled

Request Example

Bash

curl -X PATCH https://api.alterlab.io/api/v1/map/schedules/<schedule_id> \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "id": "example",
  "name": "example",
  "cron": "example",
  "timezone": "example",
  "map_config": {},
  "max_runs": "example"
}

DELETE /api/v1/map/schedules/{schedule_id}

DELETE

/api/v1/map/schedules/{schedule_id}

Delete Map Schedule

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id

Request Example

Bash

curl -X DELETE https://api.alterlab.io/api/v1/map/schedules/<schedule_id> \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "status": "ok"
}

POST /api/v1/map/schedules/{schedule_id}/pause

POST

/api/v1/map/schedules/{schedule_id}/pause

Pause Map Schedule

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id

Request Example

Bash

curl -X POST https://api.alterlab.io/api/v1/map/schedules/<schedule_id>/pause \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "id": "example",
  "name": "example",
  "cron": "example",
  "timezone": "example",
  "map_config": {},
  "max_runs": "example"
}

POST /api/v1/map/schedules/{schedule_id}/resume

POST

/api/v1/map/schedules/{schedule_id}/resume

Resume Map Schedule

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id

Request Example

Bash

curl -X POST https://api.alterlab.io/api/v1/map/schedules/<schedule_id>/resume \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "id": "example",
  "name": "example",
  "cron": "example",
  "timezone": "example",
  "map_config": {},
  "max_runs": "example"
}

POST /api/v1/map/schedules/{schedule_id}/run

POST

/api/v1/map/schedules/{schedule_id}/run

Run Map Schedule Now

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id

Request Example

Bash

curl -X POST https://api.alterlab.io/api/v1/map/schedules/<schedule_id>/run \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "id": "example",
  "schedule_id": "example",
  "status": "example",
  "map_id": "example",
  "urls_discovered": 0,
  "credits_used": 0
}

GET /api/v1/map/schedules/{schedule_id}/runs

GET

/api/v1/map/schedules/{schedule_id}/runs

List Map Schedule Runs

Parameters

Name	Type	Required	Description
schedule_id	`string`	Required	schedule_id
limit	`integer`	Optional	limitDefault: `20`
offset	`integer`	Optional	offsetDefault: `0`

Request Example

Bash

curl -X GET https://api.alterlab.io/api/v1/map/schedules/<schedule_id>/runs \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Example

JSON

{
  "runs": [],
  "total": 0
}

Last updated: March 2026