# TaskSocial Docs

> Documentation for TaskSocial, covering setup, authentication, and task management through its API.

- Documentation: https://tasksocial-docs.thally.app
- GitHub: https://github.com/Shahzebdevv/tasksocial-thally-assessment
- Full docs for LLMs: https://tasksocial-docs.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://tasksocial-docs.thally.app/ai.txt
- Structured docs index (JSON): https://tasksocial-docs.thally.app/api/docs-index
- OpenAPI spec: https://tasksocial-docs.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://tasksocial-docs.thally.app/api/docs/{page-id}
- Search API: https://tasksocial-docs.thally.app/api/search?q={query}
- Capability manifest (skill): https://tasksocial-docs.thally.app/skill.md
- Agent guidance (editing these docs): https://tasksocial-docs.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://tasksocial-docs.thally.app/api/mcp
- Agent readiness: https://tasksocial-docs.thally.app/api/agent-readiness
- Changelog feed (JSON Feed): https://tasksocial-docs.thally.app/changelog/feed.json
- Changelog feed (RSS): https://tasksocial-docs.thally.app/changelog/rss.xml

### Recommended workflow

1. Use this index, the search API, or `search_sections` / `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Get started

### Get started

- [TaskSocial Documentation](https://tasksocial-docs.thally.app/): Learn to authenticate with TaskSocial, manage your tasks, and use the TaskSocial REST API.
- [Quickstart](https://tasksocial-docs.thally.app/quickstart): Authenticate with the TaskSocial API and retrieve your tasks using curl.

## Guides

### TaskSocial workflows

- [Authentication and Tasks](https://tasksocial-docs.thally.app/guides/authentication-and-tasks): Register, authenticate, create tasks, and manage your tasks with the TaskSocial API.

## API Reference

### Overview

- [API overview](https://tasksocial-docs.thally.app/api/introduction): Explore the TaskSocial REST API, its base URL, and its authentication requirements.
- [Authentication](https://tasksocial-docs.thally.app/api/authentication): Register, log in, and send authenticated requests to the TaskSocial API.

Interactive API reference available at https://tasksocial-docs.thally.app/api