# Context

## What is a Stoobly Context?

A context is collection of [requests](https://docs.stoobly.com/core-concepts/mock-api/requests) and [scenarios](https://docs.stoobly.com/core-concepts/mock-api/scenarios).

### Default Context

The default context is automatically generated and set when you run `stoobly-agent` for the first time. Contexts are maintained by the hidden directories named `.stoobly` . For supported OSs the default context's data will be in the user's home directory e.g. `~` or `$HOME` for unix systems.

## Why have different Contexts?

### Separation of APIs

A context contains [scenarios](https://docs.stoobly.com/core-concepts/mock-api/scenarios) which are used to group requests for a user workflow. As more scenarios are created, they may become more and more loosely related. To differentiate the scenarios of various APIs, it is recommended to consider separating them with a new context. Recommended separation strategies:

* One context per API service
* One context per application

### Collaboration

Sharing contexts can be useful to show collaborators all the data for an API instead of manually exporting specific requests and scenarios and having them import each one. Instead you can share the entire context and quickly onboard teammates.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stoobly.com/core-concepts/context.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
