.. Community DevOps Agent API documentation master file, created by
   sphinx-quickstart on Tue Dec 10 00:27:39 2025.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to Community DevOps Agent API
======================================

.. image:: https://img.shields.io/badge/python-3.8+-blue.svg
   :target: https://www.python.org/downloads/
   :alt: Python Version

.. image:: https://img.shields.io/badge/License-Apache%202.0-blue.svg
   :target: https://opensource.org/licenses/Apache-2.0
   :alt: License: Apache 2.0

.. image:: https://badge.fury.io/py/devopsagent-api.svg
   :target: https://pypi.org/project/devopsagent-api/
   :alt: PyPI version

A Python client library that provides native boto3 integration for AWS DevOps services.
This library registers multiple custom boto3 services, enabling familiar AWS SDK patterns
for DevOps operations.

**🎉 NEW: AWS DevOps Agent Control Plane Service Integration**

The library now includes complete boto3 integration for the **AWS DevOps Agent Control Plane**
service (`community-aidevops`), providing access to Agent Spaces, Service Associations, and
Operator Applications with 23 API operations.

Quick Start
-----------

**Community DevOps Agent (Task Management)**

.. code-block:: python

   import devopsagent_api  # Registers all services
   import boto3

   # Create a client for task management
   client = boto3.client('community-devops-agent', region_name='us-east-1')

   # List tasks with filtering
   response = client.list_tasks(
       agentSpaceId='your-agent-space-uuid',
       filter={'status': ['IN_PROGRESS', 'PENDING_START']}
   )

   for task in response['tasks']:
       print(f"Task: {task['title']} - Status: {task['status']}")

**AWS DevOps Agent Control Plane (Agent Spaces)**

.. code-block:: python

   import devopsagent_api  # Registers all services
   import boto3

   # Create a client for agent space management
   client = boto3.client('community-aidevops', region_name='us-east-1')

   # List agent spaces
   response = client.list_agent_spaces()

   for space in response['agentSpaces']:
       print(f"Agent Space: {space['name']} (ID: {space['agentSpaceId']})")

   # Create a new agent space
   response = client.create_agent_space(
       name='my-devops-space',
       description='Development operations workspace'
   )

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   getting_started
   installation
   configuration
   api_reference
   examples
   authentication
   models
   exceptions
   changelog

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`