PromptsClient

adaline.prompts creates, reads, updates, and deletes prompts. Related prompt-scoped resources — drafts, playgrounds, evaluators, and evaluations — are exposed through nested sub-clients. Every method is async.

Access

from adaline.main import Adaline

adaline = Adaline()
prompts = adaline.prompts  # PromptsClient

The class is also exported directly:

from adaline.clients import PromptsClient

Sub-clients

PromptsClient exposes four nested namespaces — evaluators and evaluations are here (not at the top level) because every URL is /prompts/{prompt_id}/...:

Attribute	Client	Covers
`adaline.prompts.draft`	`PromptDraftClient`	Get the current draft
`adaline.prompts.playgrounds`	`PromptPlaygroundsClient`	List / get playgrounds
`adaline.prompts.evaluators`	`PromptEvaluatorsClient`	CRUD for evaluators attached to the prompt
`adaline.prompts.evaluations`	`PromptEvaluationsClient`	Create / list / cancel evaluation runs (+ `.results` for per-row results)

Types from adaline_api:

from adaline_api.models.prompt import Prompt
from adaline_api.models.create_prompt_request import CreatePromptRequest
from adaline_api.models.patch_prompt_request import PatchPromptRequest
from adaline_api.models.list_prompts_response import ListPromptsResponse

Prompt embeds a PromptSnapshot with the latest config, PromptMessage[], ToolFunction[], and PromptVariable[].

list()

List prompts in a project (paginated).

async def list(
    *,
    project_id: str,
    limit: Optional[int] = None,
    cursor: Optional[str] = None,
    sort: Optional[SortOrderInput] = None,
    created_after: Optional[int] = None,
    created_before: Optional[int] = None,
    fields: Optional[str] = None,
) -> ListPromptsResponse

Parameters

Name	Type	Required	Description
`project_id`	`str`	Yes	Project whose prompts should be returned.
`limit`	`Optional[int]`	No	Page size (default 50, max 200).
`cursor`	`Optional[str]`	No	Opaque cursor from a previous response.
`sort`	`Optional[SortOrderInput]`	No	Sort order.
`created_after` / `created_before`	`Optional[int]`	No	Unix millisecond bounds.
`fields`	`Optional[str]`	No	Comma-separated top-level fields to include.

Returns

ListPromptsResponse with { data: list[Prompt]; pagination: Pagination }.

Example

response = await adaline.prompts.list(
    project_id="project_abc123",
    limit=50,
    sort="createdAt:desc",
    fields="id,title,createdAt",
)

for prompt in response.data:
    print(prompt.id, prompt.title)

create()

Create a new prompt in a project. The optional draft seeds the prompt’s initial config, messages, and tools.

async def create(*, prompt: CreatePromptRequest) -> Prompt

Parameters

Name	Type	Required	Description
`prompt`	`CreatePromptRequest`	Yes	Prompt definition.

Returns

Prompt — the created prompt.

Example

from adaline_api.models.create_prompt_request import CreatePromptRequest

prompt = await adaline.prompts.create(
    prompt=CreatePromptRequest(
        project_id="project_abc123",
        title="Customer support triage",
        icon={"type": "emoji", "value": "🎧"},
        draft={
            "config": {
                "provider": "openai",
                "model": "gpt-4o",
                "settings": {"temperature": 0.3},
            },
            "messages": [
                {
                    "role": "system",
                    "content": [{"modality": "text", "value": "You are a helpful triage assistant."}],
                },
            ],
        },
    )
)

print(f"Created prompt {prompt.id}")

get()

Retrieve a single prompt by ID. Use expand="playground" to include the default playground.

async def get(
    *,
    prompt_id: str,
    expand: Optional[str] = None,
    fields: Optional[str] = None,
) -> Prompt

Parameters

Name	Type	Required	Description
`prompt_id`	`str`	Yes	Prompt identifier.
`expand`	`Optional[str]`	No	Pass `"playground"` to include the default playground.
`fields`	`Optional[str]`	No	Comma-separated top-level fields to include.

Example

prompt = await adaline.prompts.get(
    prompt_id="prompt_abc123",
    expand="playground",
)

print(f"Model: {prompt.config.provider}/{prompt.config.model}")

update()

Partially update a prompt. Sent as PATCH under the hood. Any field you omit is left untouched.

async def update(
    *,
    prompt_id: str,
    prompt: PatchPromptRequest,
    playground_id: Optional[str] = None,
) -> Prompt

Parameters

Name	Type	Required	Description
`prompt_id`	`str`	Yes	Prompt identifier.
`prompt`	`PatchPromptRequest`	Yes	Fields to update (all optional).
`playground_id`	`Optional[str]`	No	When patching playground-scoped fields, identifies which playground to update.

Example

from adaline_api.models.patch_prompt_request import PatchPromptRequest

updated = await adaline.prompts.update(
    prompt_id="prompt_abc123",
    prompt=PatchPromptRequest(
        title="Renamed prompt",
        config={
            "provider": "openai",
            "model": "gpt-4o-mini",
            "settings": {"temperature": 0.7},
        },
    ),
)

delete()

Permanently delete a prompt and all associated resources (drafts, playgrounds, deployments, evaluators, evaluations). Irreversible.

async def delete(*, prompt_id: str) -> None

Get started

API

SDKs

Proxy

Prompts

PromptsClient

Access

Sub-clients

list()

Parameters

Returns

Example

create()

Parameters

Returns

Example

get()

Parameters

Example

update()

Parameters

Example

delete()

See Also

​PromptsClient

​Access

​Sub-clients

​list()

​Parameters

​Returns

​Example

​create()

​Parameters

​Returns

​Example

​get()

​Parameters

​Example

​update()

​Parameters

​Example

​delete()

​See Also

PromptsClient

Access

Sub-clients

list()

Parameters

Returns

Example

create()

Parameters

Returns

Example

get()

Parameters

Example

update()

Parameters

Example

delete()

See Also