yera.cli.commands.delete
Delete commands — remove config entries and files.
Symbols
config
config(
force: Annotated[bool, Parameter(negative='')] = False,
ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → NoneDelete yera.toml and all configuration stored in it. Requires --force.
Parameters
Must be true; the command refuses to delete without --force.
Raises
If deletion is not permitted with --force.
cred
cred(
key: str,
ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → NoneDelete one credential leaf.
Parameters
Exact dotted credential name.
Raises
If the name is absent or identifies a namespace.
cred_group
cred_group(
name: str,
force: Annotated[bool, Parameter(negative='')] = False,
ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → NoneDelete a credential group and every credential it contains.
Requires --force.
Parameters
Credential group name to delete.
Must be true; the command refuses to delete without --force.
Raises
If deletion is not permitted with --force.
creds
creds(
path: str | None = None,
force: Annotated[bool, Parameter(negative='')] = False,
ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → NoneDelete credentials from the active credential group. Requires --force.
Supply path to limit deletion to one namespace.
Parameters
Optional dotted namespace to clear.
Whether destructive bulk deletion is permitted.
Raises
If force is not enabled.
If the path identifies only one credential leaf.
mcp
mcp(
server_name: Annotated[str, Parameter(help='MCP server connection to remove.')],
ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → NoneDelete an MCP server and the state that Yera owns for it.
Yera removes the server from every profile that uses it, deletes its imported tools and stored OAuth tokens, and keeps credential-group values referenced by headers.
Parameters
Configured MCP server connection to remove.
Raises
If the named MCP server is not configured.
model
model(
model_id: Annotated[str, Parameter(help='Yera model id to remove.')],
connection: Annotated[str, Parameter(help='Connection name the model was discovered under. Required since the same model id can exist under multiple connections.')],
model_type: Annotated[Literal['llm', 'embedding', 'tts', 'stt', 'reranker'], Parameter(help='Model type of the entry to remove.')],
ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → NoneRemove one model entry from the universe.
Parameters
Yera-internal dot-delimited model id to remove.
Connection name the model was discovered under. Required because the same model id can exist under multiple connections.
Model type of the entry to remove.
Raises
If no model matches the requested type, identifier, and connection.
models
models(
model_type: Annotated[Literal['llm', 'embedding', 'tts', 'stt', 'reranker'] | None, Parameter(help='If set, remove only models of this type.')] = None,
force: Annotated[bool, Parameter(negative='')] = False,
ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → NoneDelete configured models from yera.toml. Requires --force.
Supply model_type to limit deletion to that type.
Parameters
If set, only models of this type are removed. If omitted, all models across all types are removed.
Must be true; the command refuses to delete without --force.
Raises
If deletion is not permitted with --force.
profile
profile(
profile_name: Annotated[str, Parameter(help='Yera profile name to remove.')],
ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → NoneRemove a named Yera profile from yera.toml.
Parameters
Profile to remove. The active profile cannot be removed.
Raises
If the named profile is not configured.
If the named profile is currently active.
profiles
profiles(
force: Annotated[bool, Parameter(negative='')] = False,
ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → NoneDelete every profile and the active-profile selection. Requires --force.
Parameters
Must be true; the command refuses to delete without --force.
Raises
If deletion is not permitted with --force.
provider
provider(
provider_type: Annotated[Literal['anthropic', 'openai', 'mistral', 'aws', 'azure', 'ollama', 'llama_cpp'], Parameter(help='Provider type to remove.')],
connection: Annotated[str | None, Parameter(help='If set, remove only this connection rather than the entire provider. Raises an error if any Yera profile references this connection.')] = None,
force: Annotated[bool, Parameter(negative='')] = False,
ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → NoneRemove a provider or one of its connections from yera.toml.
Parameters
Provider type to remove. Must be a configured provider.
If set, remove only this connection. Raises an error if any Yera profile references it — update or remove those profiles first.
Required when removing an entire provider. The command refuses
to delete without --force.
Raises
If the named connection is not configured for the provider.
If provider deletion is not permitted with --force, or
if a profile references the provider or connection.
providers
providers(
force: Annotated[bool, Parameter(negative='')] = False,
ctx: Annotated[AppContext, Parameter(parse=False, show=False)],
) → NoneDelete every provider connection from yera.toml. Requires --force.
Parameters
Must be true; the command refuses to delete without --force.
Raises
If deletion is not permitted with --force.