Skip to main content

initialize_project

Prepare a newly-connected project: clone the repo, detect the stack, and stand up its sandbox. Moves a project from PENDING_INITIALIZATION toward READY. Runs in the background and returns immediately — poll list_projects and read status_data.status until it is READY (that’s when the project gains the workspace_id that start_task and the setup tools need). Safe to call again (no-op if the project is already prepared). Requires an admin-level user.
UUID
required
Project UUID (from list_projects).
UUID
Workspace UUID if the project already has one; omit for a fresh project.

rerun_initialization

Rerun a failed / needs-action initialization step. Use when a project’s status_data.status is ERROR or NEEDS_ACTION after you have fixed the cause (e.g. set the right install command via update_setup_config). Requires an admin-level user.
UUID
required
Project UUID.
UUID
required
From list_projects → status_data.initialization_job_id.
UUID
Workspace UUID, if the project has one.

list_projects

Read-only List the Autonomy projects visible to the authenticated user. Returns projects grouped by organization. Use this to discover the project_id and its workspace_id needed by the task tools.
string
Optional filter, e.g. ‘READY’ to show only ready projects.

list_available_projects

Read-only List every repo the org’s GitHub App can see, linked or not. These are the projects you can add with add_projects. Repos GitHub has never granted the app won’t appear here (install the Autonomy GitHub App on them first). Requires an admin-level user. No parameters.

add_projects

Add projects to the org’s active set (link them for use). Pass the complete desired set of linked project_ids — FEI links these and unlinks the rest. After adding a fresh project, initialize_project to stand up its sandbox.
array
required
Full set of project UUIDs (from list_available_projects) to make visible/usable. This REPLACES the linked set: projects not listed here are unlinked. Requires an admin-level user.