{"openapi":"3.1.0","info":{"title":"Штаб целей — API агентов","version":"1.0.0","description":"REST API для ИИ-агентов. Авторизация: Bearer shc_live_…. Значения метрик — в единицах показателя (рубли, не копейки). Чужие объекты и проекты вне области ключа возвращают 404."},"servers":[{"url":"/api/v1"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}}},"security":[{"bearer":[]}],"paths":{"/me":{"get":{"summary":"Кто я","responses":{"200":{"description":"Агент, арендатор, область, права"}}}},"/projects":{"get":{"summary":"Проекты в области ключа","responses":{"200":{"description":"Список с целями и прогрессом"}}}},"/goals/{id}":{"get":{"summary":"Цель, разделы и показатели","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Цель"},"404":{"description":"Нет доступа или нет цели"}}}},"/tasks":{"get":{"summary":"Список задач","responses":{"200":{"description":"data + next_cursor"}}},"post":{"summary":"Создать задачу","responses":{"201":{"description":"Задача"}}}},"/tasks/{id}":{"get":{"summary":"Задача с комментариями и вопросами","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Задача"}}},"patch":{"summary":"Изменить задачу. Статус done запрещён агенту.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Обновлено"},"403":{"description":"Нельзя закрыть задачу"},"409":{"description":"Ждёт владельца"}}}},"/tasks/{id}/comments":{"post":{"summary":"Комментарий","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Комментарий"}}}},"/questions":{"get":{"summary":"Вопросы этого агента","responses":{"200":{"description":"Список"}}},"post":{"summary":"Задать вопрос. Задача переходит в waiting_owner.","responses":{"201":{"description":"Вопрос"}}}},"/questions/{id}":{"get":{"summary":"Статус и ответ","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Вопрос"}}}},"/metrics/{id}":{"get":{"summary":"Показатель и последние значения","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Показатель"}}}},"/metrics/{id}/values":{"post":{"summary":"Добавить значение","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"Значение и прогресс цели"}}}}}}